Guides > Web Administrator guide

Content:

1 — Introduction

2 — Advanced site structure

2.1 — Section system properties

2.2 — Main menu

2.3 — Creating new site

3 — Content types

4 — Particles

5 — Record binding

6 — Templates

6.1 — Syntax

7 — Events

8 — Users and rights management



1 — Introduction

The Web administrator guide is currently work in progress. If you don't find information you are looking for, please come back in a few days.

2 — Advanced site structure

2.1 — Section system properties

We have already explained basic section properties in User guide. Now, it's time for a closer look on advanced section properties, accessed by selecting the "Advanced" tab on the bottom of Section properties panel.

  • callsign: Identifier of the section, which can be used to identify or categorize sections (e.g. as a parameter in template tags).
  • statistics config: Google Analytics id for this site for use in statistics module, including the "ga:" prefix.
  • templates: All templates found in /templates directory of the site root are listed in the dropdowns. When some value is not set, value from parent node is used.
    • main template: Page template used for node view page of this section.
    • inner template: Page template used for node view pages in subsections of this section.
    • detail template: Page template used for detail pages of records in this section and its subsections.
  • section visibility: [...]
  • main menu type: for more details on main menu, see following section
    • ancestral (default): Menu is inherited from closest parent with own menu.
    • own: Defines its own menu.
  • system section: [...]
  • language section: [...]
  • URL namespace: When not empty, this value is always used in as identifier of the section in URL of this section and all of its subsections. When empty, url-encoded section name will be used for URL of this section, and it will not appear in URL of its subsections.
  • language - ...: [...]
  • icon - menu: [...]

2.2 — Main menu

2.3 — Creating new site

3 — Content types

All content of a site on top of Cloudia platform is made of records of various content types. A content type can represent wide range of data, let it be viewable content (such as simple HTML formatted block, news article, blog entry, or user comment), indirectly viewable content (such as user ratings), or even more abstract records, such as bindings for Many-To-Many relationship.

[...illustration (diagram) : content type, particles structure]

Content type definition consists of:

  • Structure definition: Content type can contain any number of particles. If Cloudia records were database records, particles would be table columns. Particles represents inner data structure of the record. For example, "User" content type could have "First name", "Last name", "e-mail", and "password" particles; "Blog entry" content type would have "Date" and "Text" particles. Particles will be described in the following chapter.
  • Presentation and behavior definition: In addition to this data structure, each content type defines its display names (for administration purposes), templates used to render records of this type, events fired on various occasions and a few more miscelaneous properties. All these will be described later in this chapter.

Site administrator can use global content type, or create a new one. Content types can be copied and moved between accessible system sections (typically sites) and copied from global types in case administrator wants to alter existing global content type. [... how to] All these use cases are demonstrated in tutorial.

To access the list of content types, select "Administration" tab of the left panel in administration interface and then "Content types" section. Except for a top-level system administrator, you will see an expandable list of managed sites. [... describe left and center panel for various selections, (global), screenshots]

To edit particles (data structure) of the content type, select it in the left panel, or select "Particles of chosen content type" button of the top toolbar of the main grid when content types are listed. The central grid will then list all particles ot the content type. [... adding/ removing/ editing particles + screenshot]

To edit details (presentation and behavior definition) of the content type, you can

  • select the "Modify content type" button of the top toolbar of the main grid when its particles are listed,
  • select "Update record" button of the top toolbar of the main grid when content types are listed (or doubleclick its ID in the grid),
  • or select "Update" in the right-click context menu in the left panel.

In the detail edit window of the content type, you can see following tabs:

  • Common: [...]
  • Template: HTML snippet with Cloudia tags used to render a detail of record of this type.
  • Template for perex: HTML snippet with Cloudia tags used to render a record of this type in a node view. Templates are discussed in a separate chapter of this guide. [... link to chapter]
  • Styles: CSS stylesheet for this records of this type. Styles defined here will be appended to inlineStyles variable when a record of this type is used. (Typical use is to put <% styles %> tag to page header in page template.)
  • Events: Content type can assign a short PHP code to different events in a record lifecycle. Events are discussed in a separate chapter of this guide. [... link to chapter]
  • Description strings (...): Name and description of the content type as it will appear in the administration interface in different languages.

4 — Particles

5 — Record binding

6 — Templates

6.1 — Syntax

7 — Events

8 — Users and rights management