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.

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.

Wordpress blogs allow two different content types: static web-pages and posts. In order to create or edit a content (whether is from one type or another), the blog tool offers a text editor allowing two posibilities: HTML text-based editor and a WYSIWYG (What you see is what you get) editor. By default, Wordpress includes a “TinyMCE” editor with very few functionalities. However, the editor functionality has been increased by customizing it, following http://tinymce.moxiecode.com instructions. Thus, editing in the Morfeo Website has become easier.

Writing Rules

Content edition can be done in Write menu, which is located in Admin menu. To access there, it is mandatory to be logged into the blog and have the appropiate rights. Once logged, go to Write Post (or Write Page for static web-pages) section under Write menu.

The main steps to be done when editing contents are the following (for further information, there is a editing guide available at http://codex.wordpress.org/Writing_posts):

1. Setting the main title. Morfeo is a multilingual blog, so if the post is going to appear in several languages, it is necessary to surround the title translation between the following tags:

   

   changing xx into the appropiate language ISO code.For instance, if a post is going to be in English and Spanish, it will have to be written as follows: se expresaría:

   

2. Setting the post URL name (also called Slug). By default, any post has its own title as the URL (that is, the address) to access it. Since Morfeo has multilingual posts, the post title contains the aforementioned tags, so it is not a valid URL. It would be shown as:

   

   Instead, it is necesary to set the Slug, which is a keyword that must identify uniquely the post. It is a good practice to add the current date to the keyword (in order to guarantee the URL oneness). So, in the previous example, the resulting slug should be firstpost_DDMMYY, and the post URL:

   http://domain/archives/firstpost_DDMMYY

3. Setting the category or categories of a post content. Wordpress allows you to categorize your posts through the Categories field of the Write menu.

   

   In this field, not only is it possible to choose an existing category but to create a new one. In this case, you have to use the tags:

   

   SPECIAL CATEGORIES
   If you think that a post may be interesting for the rest of the community, it MUST be included in the category/categories that represent the interested parties. For instance, in the next figure, including a post in the Morfeo’s relevant category means that this post will appear on the Morfeo Community blog as well as on the blog where the post is published. In the same way, if you want a post to be displayed on the web of the chapter that contains your blog, this post MUST be in the category <CHAPTER>’s relevant. Similarly, the published posts which are categorized as Events are important posts for the whole Community, so they are shown on Morfeo’s blog (in the Community Events section) as well as on the chapters which contain the blog the posts are published in.
   If you are publishing in a chapter and you think that your children blogs may be interested in that information, you MUST include your post in the category which has the chapter’s name. That is, if you are publishing in the Business Support chapter, an interesting post for your children blogs MUST be included in the Business Support category.
   However, Morfeo’s Chapter is different from the rest of the chapters. If you want a post to be displayed on all the projects and chapters of the community, that content MUST be categorized as Morfeo’s relevant.
   All posts written in chapters are automatically included in the category that makes the posts flow to the chapter’s children, that is, in the previous example, all posts would be automatically included in the “Business Support” category. However, if the categories are set manually in the “Categories” section, the behavior set by default is not applied (in the previous example, the “Business Support” category will not be automatically applied). Thus, the editor is the responsible for managing the right categories.

4. Filling the post (or page) content with language tags. when editing a content, it is necessary to add the language tags in order to sepparate the different post languages, doing the same as in the post title.

   

5. Choosing your edition options. This Website provides a full WYSIWYG editor with both the basic edition functionalities (lists, tables, styles, etc.) and other user facilities such as opening a full screen to see the whole text or showing the HTML code on a new window.

   

6. Extracting a post summary. If you have a long content, setting a part of the content as a summary is recommended in order to be shown when a full post list is displayed. The tag <!–more–> (written like an HTML comment) is used for this purpose when writing on the HTML editor. If you are using the WYSIWYG editor, there is a specific button that inserts the tag for you. Pay attention to posts in several languages: if you want to use this tag, all the translations of the summary part MUST be before the tag <!–more–> and all the translations of the rest of the post MUST be put after the tag. Thus, in a full post list, the following post

   

   would look like (in English):

   

7. Paginating a static content (pages). If you have a long static page, dividing it into several pages is recommended. The tag <!–nextpage–> is used for this purpose when writing in the HTML editor. If you have several translations of one page, you MUST be careful at placing them correctly around the <!–nextpage–> tag. You can do it as it is said in the previous point (<!–more–> tag).
8. File Uploading. Contents may have an image, a PDF file, etc. as an attatchment. Adding that kind of files is easy thanks to the special tool Wordpress provides when writing a content. On it, it is possible to specify the file

   

   and to add it to the text you are editing.

   

   For further information on file upload visit http://codex.wordpress.org/Using_Image_and_File_Attachments

9. Tagging the content. You can categorize your content with a set of tags. If you have more than one tag, they MUST be separated with commas (“,”).

A writing manual has been created in order to edit well-formed posts and static pages in the Morfeo’s community. We strongly recommend each weblog editor to keep it in mind when editing a content so as to ensure an uniform edition style.

The manual is available here.