Latest revision as of 15:04, 3 April 2011

Application Developer Site - Drupal guidelines

Location

The development/staging site is here. To get access please contact Ronan Mac Laverty (macron/maclaver).

Access rights

To create content on the developer.meego.com site you need to have editor privileges. These can be obtained from the following people:

• Teemu Lukkari (ActiveArk)
• Ronan Mac Laverty (Nokia)
• Gil Quim (Nokia)
• Michael Shaver (Intel)
• Bob Spencer (Intel)

Logging in

Those who have been given access writes to the DMC CMS may log in at the following address:

http://developer.meego.com/user

Enter your username and password, which are the same you use for all other sites in the MeeGo ecosystem. Click on Log in to enter.

Once you log in, you will see this screen:

From this screen you can either edit existing content, browse/view the website content and structure, or create new content.

Click on the wrench (spanner) at the top left of your screen to enter the higher-level content management and administration menus.

Content Types

The content types available on DMC at the time of launch are the following.

• Api page (api_page) – These are specially coded pages for the api docs. The drupal developer should be the one to make updates here.
• Book page (book) – A book page is a page of content, organized into a collection of related entries collectively known as a book. A book page automatically displays links to adjacent pages, providing a simple navigation system for organizing and reviewing structured content.
• Event (event) – All events retrieved from main site by RSS/XML feed.
• External guide (guide_external) – Places a teaser into guide sections, allowing to link to external guides.
• Feed (feed) – Subscribe to RSS or Atom feeds. Creates nodes of the content type "Feed item" from feed content.
• Feed item (feed_item) – This content type is being used for automatically aggregated content from feeds.
• Guide (guide) – Used for practically everything, but primarily guides and tutorials. Must be categorized by type of guide (corresponds with the sub navigation in the guide section).
• Note (note) – Notes are simple pages, used in such places as Developer notes and Release notes. They provide a left hand navigation structure on their list pages.
• Page (page) – A general free-form HTML page (DO NOT CURRENTLY USE, if you think its needed its important to try to abstract the need and make a general content type if possible)
• Promotional block (promo) – A Promotional block can be used to place a content teaser into a section head or on the home page with different text or images then are found in the content itself.
• Section head (section_head) – Top level pages (Home, Introduction, ....). The Section head type is used to show a selection of content in a block layout.
• Section head with lists (section_head_view) – Top level pages with embedded views (lists, like guides). The Section head type is used to show a selection of content in blocks around a dominant content list.

For the majority of people only use the Guide information format.

To see this list, click on the wrench at the top left hand of the screen, then Content management > Content types.

Add new content types or edit existing content types

When you are viewing the list of content types (Wrench > Content management > Content types) look at the menu at the top right of the content list. From here you can “add content type” or edit the “fields” of existing content types.

Browse/view content

Go to Wrench > Content management > Content list.

You can browse content by whether it’s published or not, type, date posted, or date uploaded.

Click on a content item in the list to view it, or “Edit” to make changes.

Create content

Go to Wrench > Create content. From the black navigation frame on the left, choose which type of content you would like to add.

When you click on each content type, you will get a template to fill in with all the required and optional fields. Entering this information is very straightforward and help is available by hovering over a field you wish to learn more about.

Required fields are marked with a red asterisk.

If the content you have entered contains HTML, you may wish to select either enhanced HTML or raw as your format type (consult this help for more information: http://developer.meego.com/filter/tips).

Tips for creating content

External guides and guides

If you would like to connect several guides together as a “book” the developers could progress through, click on “Book outline” at the bottom of the Create Guide/External Guide page.

In the book field, you can either create a new book or add the guide to an existing book.

To ensure your guide/external guide has a description in the guide lists, click on List information at the bottom of the Create Guide/External guide page and enter a brief description. You can also upload an image here so it will have an image in the guide list page as well.

For all content types (but most likely pages or guides)

Content in menus

If you would like a page or guide to show up in the sub-navigation, click on “Menu” at the bottom of the Create <content type> page. In the PARENT ITEM field, select the navigation element you would like the page to appear under, then name it in MENU LINK TITLE.

Meta tags

Here you can add the metadata description, which will help people searching determine whether that page is relevant or not. Make metadata descriptions approximately 150 chars (with spaces) or less.

Section heads and Section heads w/lists

These are the landing pages of the site, and here you will most likely want to add promotional blocks as the content used here. So therefore, it’s prudent to create your promotional blocks first, then start adding the promo block titles in the “Content to feature” fields on the Create Section head page.

You can also adjust the layout of the promo blocks on a section head page by clicking on “Row layout” at the bottom of the Create page, then selecting the desired amount of promo blocks in each row.

Top links can be used to add more teasers in the banner area of the landing pages (section heads), but as they are not very attractive, they should be used with caution, perhaps only to show major/critical announcements.

Edit content

You can edit content either from the Content list, or by navigating to the page you would like to edit and selecting Edit from the menu on the left hand side. If you do not see this menu, click X to close the content management menu:

It will return to the wrench icon and you should see the option to “Edit” the page.

Delete content

Go to the page you would like to delete, click on Edit, then Delete.

Remove promo blocks from section heads

If you wish to delete a promo block from a section head, but still keep the promo block, go to the section head and click Edit. Then in the “Content to feature” field, just delete the title of the promo block you want to remove.

Changing navigation and sub-navigation

Go to Wrench > Administer > Site Building > Menus > Primary links.

Here you can enable, disable, edit and delete what is shown in the navigation. Click Save configuration when you are done.