Installation manual of new project blogs

An installation and configuration manual has been created in order to facilitate the installation of new project blogs in the Morfeo’s community. This guide is available here.

Installing a Morfeo weblog

Additions to Wordpress

As well as having the typical blog and existing Web (with Joomla) functionality, the new Morfeo Community website needs to be able to add news and events regarding the various developing projects. In order to do this, the following plugins have been added:

  • Language Switcher: Allows the maintenance of a bilingual or multilingual blog, allowing the translation of content such as categories, options, administration, etc. To install the Language Switcher, simply follow the recommended steps of the following document http://www.poplarware.com/bilingualblog.html, - as you will see, some Wordpress files will need to be modified for plugin compatibility – and install the plugin from http://www.poplarware.com/languageplugin.html. You will also be required to add the necessary translations (for more information, please see http://www.poplarware.com/languageplugin.html) which can be found in languagesof the wp-includes directory of the Wordpress installation (the .po and .mo files).
  • Collapsing Page Menu: Shows an unordered list of static pages that open or fold based on the current page.
  • Friends RSS Aggregator: Adds a collection of RSS feeds from other blogs and organises them into categories. The plugin, which can be found at http://adam.404.org/projects/friends-rss, has been modified several times since it is incompatible with version 2.2 of Wordpress. Changes have therefore been made to the part of the >friends_rss.php file that calls the function get_linkobjectsbyname, which is now obsolete. >friends_rss.php now calls the get_bookmarks(“category_name=$category”) function. Similarly, changes have been made to the file so that the Friends RSS Aggregator is compatible with the Language Switcher. obtains the language in which to display the RSS elements via the functions provided by the plugin. The wp-admin/index-extra.php file has also been modified to avoid a possible error on the main admin screen, commented on line 3:
  • require_once (ABSPATH . WPINC . ‘/rss.php’);

    It is important to note that the Friends RSS Aggregator plugin does not cover all the requirements of the Morfeo Website due to the fact that it has been modified by the FI-UPM to contribute all the necessary functionality, thus changing the name to RSS Aggregator. The plugin’s administration has been modified to manage various RSS feeds, organised into categories in the appropriate manner and depending on the requirements, by adding them to specific categories. The plugin’s configuration has also been modified (in the wp-content/plugins/rss-aggregator/rss_fetch.inc file) so that access to different feeds can be made via a Proxy. Other improvements made to the plugin include the addition of a Cron process, which automatically updates the RSS cache so that the required RSS additions will already be included in the access to the website, and the addition of a maximum 60 minute cache time (as seen in the wp-content/plugins/rss-aggregator/rss_aggregator.php file), so that if a synchronisation Cron process does not already exist, the cache will be updated with the website’s first access that is carried out during this time.

  • PJW Mime Config: Extends the list of mime types supported by the Wordpress file upload tool.
  • Search Everything: Expands the Wordpress search abilities to elements other than posts, for example static web pages.
  • Social Bookmarking Reloaded: Adds the logos of the most used social tagging services to managed blog content in order to facilitate the tags. This plugin has also been modified to allow the posts, created in the Events category, to add a new logo of the said event to the Google Calendar.
  • Simple Tagging: Allows the author of the appropriate content to add key words, which will be displayed in the form of Tag Clouds, to ease searching and user navigation.
  • BackupWordpress: Allows the administrator to easily backup blogs, as well as schedule daily or weekly backups.
  • Email Immunizer: Protects e-mails against spam that could appear in posts and static web pages published in the weblog. This plugin is automatically configured to modify published e-mails by randomly changing some characters to their ASCII code equivalents. This helps to stop malicious bots from obtaining e-mail addresses without the user’s permission.
  • Random AntiSpam: Protects comments from automatically machine generated spam. To do this, the plugin forces the user, who wishes to comment on a post, to carry out randomly generated Captcha code.

These plugins should be stored in the wp-content/plugins directory of the Wordpress installation and should be activsted from the Wordpress administration zone. Once installed, you will be able to configure Wordpress as appropriate.

As well as installing and configuring plugins, many also require modifications to be made to their templates; to add specific code that allows the effects of the plugin to be displayed. Such modifications have been made to a template created for the Morfeo website, which provides the website with the desired look and feel and includes all of the desired functionality to display the functionality provided by the previously described plugins.

The creation of this template (located in wp-contents/templates/morfeo) has lead to the addition of the following files, which are not standard to all Wordpress templates:

  • The navbar.php file specifies an array whose key-value pairs determine the layout of the tabbed website navigation bar. In this way, new elements can be added, where the key would be the text to be displayed and the value would be the address of the link that would open the appropriate page in a new tab.
  • The linkfeeds_by_date.php file adds a new layout, which should maintain the same aspect as the rest of the template, to the page that displays the events added to the associated community project blogs.
  • The pagetemplate.simpletagging.php and sidebartag.php files provide the relevant layout to the page that displays the data in the form of one or more tags. The pagetemplate.simpletagging.php file manages the main body of the pages and the sidebartag.php file manages the menus. Like with the linkfeeds_by_date.php file (above), these files should maintain the same aspect as the rest of the template.
  • The logos.php file allows including the funder logos as well as the project member logos. In this file it is possible to specify the name, URL and logo of each entity so that this information is shown either within the “funded by” section, in case of funder entities, and within the “members” section, for the member logos. If both sections are not supposed to be shown, just do not include any reference to entities in the logos.php file. Besides this, the logos directory allows storing the entity logos images described in the logos.php file.
  • The ie.css and iefixes.js files provide the correct website view in both the Internet Explorer 6 and 7 web browsers. It is important to note that the style.css file guarantees the correct website view in FireFox.