Jojo_article plugin

The jojo_article plugin is our most developed plugin, and can function as a blog, article database, event list, or as a news section for your website.

We have a number of options available for this plugin, and other plugins enhance the functionality further.

Installation

The jojo_article plugin is installed by default with a new site. There will be an "Articles" page on the main menu, and an "Edit articles" page unger the content tab of the admin area.

The jojo_article plugin will not function without the jojo_tags plugin installed, which is also installed by default.

Choosing a URI

By default, the articles plugin is available from www.domain.com/articles/ and the actual articles are underneath this, eg www.domain.com/articles/my-article/.
This behaviour can be changed by editing the URL field of the article page, under "Edit pages".


Article plugin options

There are a number of options available for the article plugin. These have good descriptions, so each option should be more-or-less self-explanatory.


Adding article snippets to a sidebar

A common task that developers want to do is to add a short teaser of the article to the sidebar of their site. "Latest articles" or similar.

This requires a small amount of coding, but does not require changing of core code.

You will need to edit 2 files to achieve this - firstly the template file of your theme, template.tpl, and also global.php in your theme.

themes/YOURTHEME/global.php

You will need to add some code to global.php in your theme. If this file does not exist, it will need to be created, and you will need to run www.domain.com/setup/ after creating the new file.

The following code will fetch the latest 4 articles from the database and create a Smarty variable called $sidebararticles.
if (class_exists('JOJO_Plugin_Jojo_article')) {
$smarty->assign('sidebararticles', JOJO_Plugin_Jojo_article::getArticles(4));
}

You may not want to get the latest 4 articles - you may want 10 articles, starting at the fourth.
if (class_exists('JOJO_Plugin_Jojo_article')) {
$smarty->assign('sidebararticles', JOJO_Plugin_Jojo_article::getArticles(10, 4));
}

This functionality is currently used on www.ragepank.com for displaying the first 6 articles with full snippets, then the next 10 or so articles with titles only.

themes/YOURTHEME/templates/template.tpl

Now that a Smarty variable has been created, we need to use it in the template.
Place the following code in your sidebar, or wherever you want the content to appear.
{section name=a loop=$sidebararticles}
<div>
<a href="{$sidebararticles[a].url}" title="{$sidebararticles[a].ar_title|escape:"html"}">
<strong>{$sidebararticles[a].ar_title|escape:"html"}</strong>
</a><br />
{$sidebararticles[a].bodyplain|truncate:200:"..."} <em>{$sidebararticles[a].datefriendly}</em>
</div>
{/section}

Feel free to customize this HTML code to suit your design. Note the "truncate:200" in this code, which will shorten the article text down to a 200 character snippet (otherwise the entire article is shown). There are many more options available for truncating text in the Smarty documentation.

Article comments

Comments are enabled by default, and can be disabled via the options. Any comments made will go live immediately, and links have a nofollow attribute on them, consistent with other blogging platforms such as Wordpress.

When a comment is made, the site webmaster gets an email (as defined in the "Webmaster address" option). The email includes links for deleting and following the comment.



Article comments include a CAPTCHA, which is there to prevent spam. The CAPTCHA does not appear for logged in users. If you are having trouble with the CAPTCHA not working, this may be related to the Freetype library not being installed on your webserver - in which case please contact your host, we have found most are happy to help out (this problem is not unique to Jojo).

SEOing your articles

Blog posts and articles can be a fantastic way of driving traffic to your website. So long as a few guidelines are followed.
  • Before starting to write an article, spend a few moments thinking about what phrases you would like the page to rank for.
  • Include those phrase in the front of the SEO title.
  • Try to incorporate those phrases into the article heading/title, while still being catchy.
  • Incorporate your phrase into the URL.
  • Make mention of the phrase and variations in the first paragraph of the article.
  • Create a meta description which includes the phrases you want to target. Watch the counter on the meta description field to ensure is stays less than 156 characters.
  • Link to the article from other articles - encourage people to read your content.

Jojo articles have search engine freindly URLs, a default meta description if you don't add one, are entered in the sitemap plugin, are on the XML sitemap, and are able to be pinged to the various blog pinging services.

Combined with good content and links from other sites, these article pages can rank very well.

Tags & related articles

The jojo_article plugin requires the jojo_tags plugin. Tags are a way of categorizing and sorting articles and other pages of content from a website.

If you enter tags against an article, these will appear below the article as links to the tags pages. If the appropriate option is enabled, then 5 related articles will be shown at the bottom of the article as well. The goal is to encourage the user to read other content on the site, rather than leaving. The more content in the system, and the more the tags are used, the better the relevancy of these related articles.

RSS Feed

The jojo_article plugin includes a RSS feed, which contains the 15 most recent articles (please just ask if you would like this to be customized via an option). Users will use this feed to get notified about any new articles you post, websites will syndicate your content, and scrapers will try to create spam sites based around your RSS feed.
You can optionally include the entire article in the RSS feed, or just the first few sentences. If you choose to include the full article, we highly recommend you also enable the "link back to source" option, which goes a small way to preventing duplicate content penalties.

Integrating with Feedburner

Feedburner is a service which provides statistics on how many subscribers are using your RSS feed. After submitting your feed to Feedburner, they will provide you with an alternative URL to get people subscribing to.
Jojo includes a Feed icon in the head of the web page, which points by default to "www.domain.com/articles/rss". To change this so that the Feedburner URL is advertised, please enter your Feedburner feed URL in the "External Article RSS URL" option.


This doesn't have to be Feedburner, it can be another competing service.