• View
• Edit
• History
• Attach
• Print
• Backlinks

XESBlog

Questions answered by this recipe

How can I create a Blog in PmWiki without having to pull together all the components and tricks to do it myself?

Answer

Δ

Install XES Blog package and it will give you a bunch of functionality and step-by-step instructions to get up & running with a blogging engine in your PmWiki installation. Currently this recipe is set up for the administrator (admin) to create blog entries and manage the website, and website visitors are allowed to add comments to the website.

Description

Blogging recipe - compilation of other recipes and custom functions.

Features

See XES Blog - Use for usage documentation.

Notes

All screenshots are on a (pretty-much) bare-bones install of PmWiki with very little formatting/css added.

Step One: Add files to server

Download, expand and install xesblog.zipΔ components: everything inside the cookbook folder should be added to your cookbook/ directory, the xeslib.d folder should be placed in the same folder as contains your wiki.d folder, and the blog-images folder should be placed in the root of your web directory. Other configurations are possible, but this is how the package was set up, and you'll have to fiddle if you change it.

Step Two: Installation

Add the following text to your local/config.php file:

$XesEmailNotify = "email@example.org";
include_once($FarmD.'/cookbook/xesblog.php');

Change email@example.org to the email address where you want to receive notifications.

Step Three: Pimp your sidebar

When Logged Out

When Logged In

Make the following tweaks to the bottom of your sidebar (or add these links, lists, & icons to other chosen area of your website):

* [[Blog/Blog]]
* [[Blog/TagCloud | Blog Cloud Index]]
* [[Category/Category| Tags]]
* [[BlogArchive/Blog Archive]]

[[Blog/RecentChanges?action=rss | Path:/blog-images/blog-rss2.0.gif]]

[[Blog/RecentChanges?action=atom | Path:/blog-images/blog-atom.gif]]

----

Backlinks:

(:pagelist link={*$FullName} fmt=#titlespaced group=-Site,-PmWiki:)

----
(:if auth admin:)
(:newpagebox base=Blog.Blog label=Blog:)

* [[ {*$FullName}?action=logout | logout]]
(:else:)
* [[ {*$FullName}?action=login | login]]
(:ifend:)

(:if auth admin:)[-[[Site.SideBar?action=edit | edit SideBar]]-]\\
[-[[Site/XesCommentsTemplates?action=edit | edit Blog Comments]]-]

[[Comments/Unapproved \
| (:pagelist name=-GroupFooter,-GroupAttributes,-RecentChanges,-Unapproved \
group=Comments fmt=count if="!equal {{=$FullName}$Xes_Approved} true":) \
unapproved comments]]
(:ifend:)

Edit as necessary -- if you changed the blog group, you'll need to tweak this setup.

Step Four: Enable public comments & pingbacks

Δ

Navigate to Comments/GroupAttributes?action=attr in your installation and change the edit password to @nopass to allow the public to leave comments. Do the same with Pingback/GroupAttributes?action=attr

Step Five: Go crazy

Feel free to upgrade any of the component packages that are installed -- each is maintained separately by other recipe authors and may have been upgraded before this recipe is updated. Also, poke around pmwiki.org and learn how to add functionality, more add-ins, and redesign your website, however often you'd like.

Step Six: Make it pretty.

Here's some CSS to customize a few components. Add to pmwiki/pub/css/local.css (create the file if it doesn't exsit):

div.category { 
  background-color:  #EEE;
  margin-top: 20px;
  text-align: right;
  padding: 0px 20px;
}
div.category a { 
  color:  #333;
  font-style: italic;
  font-size: 85%;
}

form.xesapprovebutton submit {
        text-align: right;
}
.commentblock {
padding: 20px;
border-bottom: 1px #333 solid;
}

Functionality notes

Δ

I do have to document one of the more obscure features of the package. I've added an attribute (variable value) to pages in the Comments/ group -- $Xes_Approved. This value is set to "true" (note this is a string value) when a page has been approved by the administrator. When doing pagelists of comments, you will want to keep this attribute in mind. It is used to filter approved from unapproved comments, as in this sidebar example (also above):

(:pagelist name=-GroupFooter,-Unapproved\
 group=Comments fmt=count if="!equal {{=$FullName}$Xes_Approved} \
true":)

Release Dates

2008-04-01

Thanks to Hugo for help with the FarmD component for the package. Now should be Farm compatible. Also added recipeinfo per Cookbook Recipe suggestions.

2008-01-08-07

Some of the changes that were supposed to be in yesterday's release were not uploaded. Today: fixed xeslib.d pagestore issue, you can now turn off Pingbacks in case you don't have PEAR (add $XesAddPingbacks = false; to your config.php file), and I tested it on a clean install of PmWiki to squish bugs. A few pagelists were tweaked, and more....

2008-01-07-06

Now RSS feeds are more configurable, with default values set up and a bunch of variables that can be set by the user. "Blog.Blog" is now the default blog homepage, and 150 is the default number of categories in the TagCloud -- to use the recipe out of the box you only need to set the email address for notifications and include xesblog.php. Resolves issues where general RSS would show pages & groups you probably didn't want it to, so now general RSS feeds are restricted to groups and pages you probably want to show up in the feeds, and all of this is in SDV variables so they can be overridden in config.php.

2008-01-07-05

Fixed RSS feeds so they now work site-wide instead of blog-only.

2008-01-06

Note change to backlinks pagelist in sidebar to fmt=#titlespaced. Added captcha.php to bundle. BlogArchive pages fixed in the xeslib.d pagestore (hopefully). -- to fix manually change BlogArchive.GroupHeader to:

(:pagelist group=Blog link={*$FullName} \
list=normal name=-Blog,-GroupHeader,-GroupFooter,-RecentChanges,-TagCloud,-SideBar \
order=$:timestamp fmt=#title:)

2007-12-17

Fixed Comments group redirect to point to correct Blog page (timestamp regex added)

2007-12-12

Adds automated monthly blog archives, fixes sidebar link problems, tweaks some features

2007-12-04

First package release

To Do

• Fix pingbacks - probably not working yet, forgot the special pingbacks PEAR package from the recipe....
• Can't tell if Google pings are working....
• Move more configurable items to SDV vars.
• i18n.
• fix bugs
• add pingback display in templates.... (oops)
• add support for more than just RSS extended content feeds....

See Also

In action:

• http://crisses.org/Blog/Blog

Documentation/Use notes:

• XESBlog-Use

(contributor packages below...)

Contributors

This recipe borrows from many other recipes. Here's a partial list of credits, by no means in any specific order:

• XMLRPC
• Bundle4Blog
• Pingback (if upgrading, note that the lowercase pingback.php should be renamed to pingback_pmw.php and the modded PEAR file remains Pingback.php -- MacOSX doesn't care about upper vs lowercase and wants to overwrite the lowercase with the uppercase file....this change keeps the module cross-platform compatible)
• Backlinks
• TagPages
• ListCategories
• CommentsSplit
• PmForm & captcha
• EnhancedWebFeeds
• GoogleBlogPing

The rest of the credit goes to PmWiki's flexibility and I take some credit for getting tired of people saying blogging doesn't exist yet, and making it work as a cohesive package. Not sure how much of this functionality people wanted added to the core, but whenever possible I used [Cookbook/PmForm]] and core principles for building this package, so it should be able to stand tough for quite some time.

Comments

This space is for User-contributed commentary and notes. Please include your name and a date (eg 2007-05-19) along with your comment. Optional alternative: create a new page with a name like "ThisRecipe-Talk" (e.g. PmCalendar-Talk).

When you approve comments, in the recipe a status message is set, but it isn't shown when you approve a comment. Adding a GoupHeader with (:messages:) solves that. This is a quick fix, so the output is visible, but doesn't stand out.

What would it take to condense the old posts, i.e. show only the posts of this month and provide a link to the posts of a previous month (if present).

The way I set up the Blogs, it might be as easy as (:pagelist link=BlogArchive.{$thismonth} fmt=#include:) where you define {$thismonth} in config.php as "today's date" in the 2008-03 format. Note that if you do this, the page will be blank in the beginning of the month -- not usually recommended in blog-land :) XES March 01, 2008, at 04:31 PM

Addendum: You should perhaps try: (:pagelist link=BlogArchive.{(ftime fmt="%Y-%m")} fmt=#include:) -- it doesn't require creating new page variables in config.php XES April 01, 2008, at 12:17 PM