Summary: How to blog using XesBlog recipe
Version: 0.1
Prerequisites: XESBlog
Status: beta
Maintainer: XES
License: CC0
Categories: Blog

Questions answered by this recipe

Ok, I've got the XES Blog recipe installed, now how do I use it?

This section is optional; use it to indicate the types of questions (if any) this recipe is intended to answer.


Instructions on how to use your XES Blog effectively.


These instructions are separated from the instructions to get XESBlog up and running because installing a script is very different from actual blog use workflow issues. If you install the scripts, get them working, and you have many other users for your blog, you can simply direct your users to this page and they don't have to slog through technical/administrative information to write a blog post on your website.

Blog Entries

  1. Log in (as admin) - as if you were going to edit your website
  2. Use sidebar "blog" title form to create a new blog entry - a new edit form will open ready to create the blog entry
  3. Make sure you explicitly title your post using the (:title:) tag
  4. Type out the contents of your post, adding any attachment links you'd like to the body of your post
  5. "Save Draft"
  6. Upload your attachments, proof your post, re-edit, and "Save Draft" as needed to be happy
  7. Tag your entry
  8. Fuss if you want to, you can edit the page, add more tags, add & upload photos or documents (Attach:), etc.

    Note: The Tags do-hicky should only appear if you're logged in as admin of the website -- or maybe if you have edit permissions -- when creating a blog entry. It won't be seen otherwise. Right now the best way to use the recipe is with admin permissions (except for visitor comments) -- I have yet to try making it work with AuthUser & edit permissions rather than admin permissions.
  9. When you're done click "Publish"

Comment & Pingback Approvals

  1. Log in (as admin) - as if you were going to edit your website
  2. See the number of unapproved comments/pingbacks (once working) in the sidebar
  3. It's a link: if you have any unapproved comments, click the link
  4. Edit or approve each comment you like (or those you don't like, but still aren't spam)
  5. To delete a comment click "edit comment" and replace the data field with "delete" just like a webpage on your site, and Publish.

Auto-Populate pages

The following pages should auto-populate once you have blog entries and/or tags: Blog.Blog, Blog.TagCloud, Blog.BlogArchive.

This page will have all recent blog entries, latest at the top. They will state whether there are approved comments, with a link to the blog#comment page at the comment anchor, and invite comments with a link to the comment form for that specific blog entry. Titles of blog entries link to the full blog entry, including comments and comments form. This is the same general behavior as WordPress and other blog applications. Each Blog.Blog entry lists its own tags, which link to the Category page for that tag (so that other posts with that tag can be seen), and has a link to the archive page for that month's posts.
This page will auto-populate once you have tags on your blog entries. The more posts you have with a specific tag, the larger that word will become in the list. This is found on a number of blogs.
This is a list of links where there are posts, by month. People can quickly find last month's posts. This is especially important for people who post very frequently.

Sidebar note

Path: is an Intermap and should resolve to the base url of your website -- if you're at something.example.com/~brian/ however, it won't work -- you'd have to do Path:/~brian/...

Release Notes

  • 2008-01-06 -- Thanks to emails & comments from Brian, I have fleshed out some of the more obscure features of the blog recipe.
  • 2007-12-06 -- If I'm going to document it for clients, I may as well document it for everyone.

If the recipe has multiple releases, then release notes can be placed here. Note that it's often easier for people to work with "release dates" instead of "version numbers".

See Also




User notes? : If you use, used or reviewed this recipe, you can add your name. These statistics appear in the Cookbook listings and will help newcomers browsing through the wiki.