Content Editing

All of the free-form content pages in your website are created and edited using the dotCommunity Content Management System (CMS).

CMS Administration Interface

Screenshot of admin interface in CMS

The above diagram shows an example layout of the CMS, when you go to the Content Management tab in the admin pages. This is the main view with no pages currently selected. You can get to this page at any time by clicking on the Content Management tab.

All content is arranged in the Site Map (1 in the diagram) as a tree of pages. In this case we have the site homepage, "Demo Site", and three pages below that: "News", "About Us", and "Example Page". Beneath "News" there is a further page, "Exciting News". The Photo Album application is also enabled, which you can see in the Site Map in grey.

Directly beneath the Site Map you can see the "Not Found" page, listed under Special Pages. This page is shown to any visitor who reaches your site but goes to an invalid URL. You could edit this to suggest which links they should try.

There is a search bar (2) which you can use to find pages to edit in your site by searching on the page content.

The In Production section (3) only appears if you have any pages which you have created but not yet published. In this case we have one page, Example Page, which is not yet published.

Finally there is a set of quick links (4) for creating a new Page or a new News Story. News stories are placed in the News folder, and are automatically included in the "Latest news" Includelet on the front page of your site. For more information on Includelets see the Layouts section of the documentation.

The Site Map (1)

The Site Map is a hierarchical view of the pages within your website. Any item in grey is an application and clicking on the link will take you to the administration pages for that application. An item in red is a content page, and clicking on it will take you to the CMS admin page where you can edit it. The currently selected item will be highlighted in bold and black.

Modifying an Existing Page

To edit an existing page simply click on it in the Site Map (1). You will be presented with a set of subtabs, and you should select the Edit tab.

CMS Edit Tab

Creating a New Page

There are two ways to create a new page. The simplest is to use the quick links (4) on the CMS admin page. Pages are created on the level directly beneath the site homepage in the site map. News Stories are place in the News folder, if you have one.

The second way to create a page is better if you want to control exactly where in the site map the page is created. What you do is click in the Site Map on the page in the hierarchy that will contain the new page. (In the above diagram you would select the News page to create a page inside this section, or the homepage if you want a page at the top level of your site). After selecting the page in the site map, click on the Create Item button. You will be presented with a drop down list of types of content page you can create, currently available content types are:

  • Page - A standard content page with a Title, a Menu Title, and an area for text.
  • News Story - An content type that includes extra information for news stories including a teaser to be displayed on a news story list.
  • Folder - A very simple item useful for creating folders of other content pages.

Select the one you would like, click Go, and you will be presented with your new empty content page.

Editing Content

CMS Editing Content

Whether creating a new page or editing an existing one, you will be presented with a similar form, which looks like the above. The important components of this page are:

Editing Subtabs (5) where you can select what you want to do with the current page, be it edit the content, change the layout, set custom permissions, or configure the publishing.

There are a set of action buttons (6) which allow you to cut/copy/paste the page to a new location, delete the page, or create a new page below this one.

The revision history (7) indicates which version of the page you are editing. The currently selected page is shown in bold and black, and the currently live version is shown with a small arrow next to it (as shown in the "Key" box).

Once you have edited the page contents in the form, you can choose to Save Changes, or Save and Publish (8). You can save the page at any time, though your changes are only visible on the website once published. This is a useful feature allowing you to edit and re-edit a page before making it live on your website.

Edit Fields

To complete your page fill in each field with the content you would like. Each content type has a set of fields that are relevant to that type. The possible fields and their meanings are:

  • Full Title - The main title of the page, shown at the top of the page and in the browser's title bar.
  • Menu Title - A title that will be used in the navigation menu, the site map, and as the basis for the URL of the page. For this reason the menu title is usually simpler and shorter than the full title.
  • Teaser - A headline for the page which is used in listings of pages. For example in a list of news items.
  • Body Text - The main body of the page, which can contain text, images, tables, etc.
  • Keywords - Some words specifically associated with your content. These are not visible to the public but allow the page to be more easily searched for.
  • Description - A one line description of the page. This is not visible to the public but allows the page to be more easily searched for.
  • Include in Navigation Menu - This option determines whether the page will be shown in the main navigation menu of your website. If you select No you will need to link directly to the page in some of your existing content if you would like visitors to use the page.
  • Show Title in Full Page View - All content items show their title at the top of the page by default. If your content doesn't need a title, or the title is shown in some other way, select No to turn it off.
  • Create RSS Feed - This option creates an RSS feed of this page and all the pages below it.

When you have completed the form click Save Changes to have the system save your page but not make it available on your website, and Save and Publish to save your page and make it visible on your website.

If you would like to see how your page will look before you publish it click the Preview action button. This will not make it available on your website but will show you how the current page will look when it is published. Note: the preview action displays the page as it would look at the point it was last saved. To preview your currently edited content you must save it first.

For detailed instructions on using the WYSIWYG editor, please read the WYSIWYG section.

Revision History (7)

Every time you publish a page a new version of the document is created meaning that at any time you can go back and review all the previous versions. It is also possible to "rollback" a document such that the published live version on your site is a previous version. For more information on publishing different versions of a document please read the Publishing section.

The revision history shows the creation date and time of all versions of the page you are currently editing. As laid out in the key (below the revision box) a red arrow next to a version indicates the current live version of the document. As the revision history is a historical record of the document it is not possible to go back and edit previous versions. Saving changes (even changes to an old version) will create a new version of the page.