Siteseed.de

Utility Link | Utility Link | Utility Link

Documentation

siteseed logo

Static Section Pages

The Static Section Page (Static Section) feature allows mapping of html pages to sections. These html pages may be placed/stored in any directory within the site root of your siteseed installation. The only exception are siteseed system directories (e.g. bo).

Figure 1:
The extended "Technical Staff" menu.
If you enter the Back Office of your Siteseed installation as a technician, you will notice that the "Sections"-Box has been extended by an additional option called "Edit Structure". And the option "Edit" has been renamed to "Edit Sections".  Please see figure 1.

  1. Edit Sections
    Press this link to access the sections editor. The sections editor got a slightly altered design and two new features related to static sections and the site library (Sitelib). See "Edit Sections" for more details.
     
  2. Edit Structure
    Press this link to access the structure editor. The structure editor allows to create static section pages. Please see "Edit Structure" for more details.

If you are only able to see the "Edit" option in your "Sections"-Box, please update to a current version of Siteseed. Don't forget to run setup.php to also update the table structure of your Siteseed installation.

Edit Sections

The section editor works like you have been used to. If you choose to "Modify" a section, you will notice that the old design has been modified slightly and two new features have been added. See figure 2 for an overview.

Figure 2: Section Editor in "Modify" mode.

  1. Back
    Return to browse mode of section editor. Changes are will not be stored
     
  2. Name
    Name of current section to be modified.
     
  3. Redirect to URL
    Allows to define a URL (must start with http://) as redirect target. If a section with redirect URL is called, an http header with this target is sent to the client. Useful for redirections to external (non Siteseed) URL. Leave blank for no action.
     
  4. Visible in Sitelib
    Allows to set section visible or invisible for Sitelib. This allows adding sections conveniently to menus generated by Sitelib functions. Be careful, a section set to invisible can still be accessed directly by URL.
     
  5. Static Section Path
    Displays the path of the static section file defined, if available.
     
  6. Interface
    Allows to define the interface of the current section.
     
  7. Content by default
    Nothing, page object, article, and search engine are the options you are able to choose from.
     
  8. ID
    Used to define page object, article, and search engine by id. See Content by default.
     
  9. Comments
    Enable or disable the comment feature for the selected section.
     
  10. Comment's Layout
    Used to define comments layout by id. See Comments.
     
  11. Modify
    Press "Modify" button to store changes and return to browse mode of section editor.

Edit Structure

Click "Edit Structure" to enter the structure editor. The default mode of the structure editor is browse mode. See figure 3 for getting an impression of the editor in browse mode.

Figure 3: The section editor. (Browse Mode)

  1. Mode Selection

    The mode of the structure editor can be changed easily by clicking on the mode icons located on the upper right.
     
    Browser Mode
    Allows to browse the directory tree and to create and delete directories and static sections
    Static Section List
    Lists all static section files and provides additional information about them
    Rebuild Static Sections
    Allows to rebuild (rewrite) all static section files depending on your current config.php and the information stored in your database.
     
     
  2. Current Location

    Shows the current browser location.
     
  3. Refresh

    Press this button to refresh the browser.
     
  4. Select

    Icons in that column indicate the type of the listed documents of the current directory. Some of them can be used to select files and directories in order to perform operations. This done by a simple mouse click.
     
    Non System Directories
    Non system (Siteseed) directories can be selected
    Static Section Files
    Static section files can be selected, too.
    System Directory
    System (Siteseed) directories cannot be selected.
    Other Files
    Non section files cannot be selected. 

  5. Document

    File or directory names. If you click on a document name, the document will be opened for viewing in your browser.
  6. Operations Menu

    Lists operations you are currently able to execute. Availability of operations depends on current context and selected document type.

Creating a file for section mapping

Select the operation "New Section Page" and Siteseed will show you the form depicted in figure 4. First you need to enter a file name including extension. Be careful, the extension needs to be a valid PHP extension. Otherwise the PHP code that implements the mapping functionality would not be executed but output as simple text. People would probably wonder about that ;-) Note there is no file extension default, you need to provide the extension manually. Of course, if your Apache/PHP installation does also parse HTML files with PHP, you are allowed to use the extension '.html', too. In case you don't know what extension to use take '.php', this should always work.

Figure 4: The "New Section Page" dialog

Next select an available section using the drop down menu. See figure 5. You are only able to select sections that have not already been used for creating other mapping files. Press 'Submit' to create the new section page. Internally the section ID and the path to the section page are stored. This allows to create menus with static URLs automatically. See Sitelib documentation for more details regarding menu generation.

Figure 5: Selecting an available section

After pressing the submit button the new section file should appear in the document listing like in figure 6.

Figure 6: Selecting an available section

Of course after creating section files you are able to edit them, see figure 7. The edit dialog appears after creating a section file or after clicking on the select icon of a section file and selecting 'Edit' from the operations menu, see figure 8. However, right now it is not possible to rename files. Once you have created them you are only able to change the section mapping property. If you need to rename files, you have to delete them and then create them again using the new name.

Figure 7: Editing Section Files

Figure 8: Available operations for section files

If you want to delete a section file, select it by clicking on its select icon. Select operation 'Delete', see figure 8. After that it should be deleted. A status message indicates the operation result (like after all executed operations), see figure 9.

Figure 9: Status message after deleting a section file

Static Structure Overview

This view provides a quick overview of all created static section files, see figure 10.

Figure 10: Overview of all static section files

  1. Select

    Allows to select a static section file
  2. Path

    Paths of static section files
  3. ID

    Section ID
  4. Section Name

    Section name
  5. Visible

    Visibility of section, see 'Edit Sections' above.
  6. Delete

    Allows to delete a static section file.
  7. Sum

    Sum of all static section files

Rebuild Static Section Files

This view allows to rebuild all static section files. This may be necessary due to moving your site to a new server or in case you accidentally deleted a section file while working with your ftp client, etc. Figure 11. 

Figure 11: Status message after deleting a section file

Printer friendly version

-

Static Section Pages The Static Section Page (Static Section) feature allows mapping of html pages to sections. These html pages may be placed/stored in any directory within the site root of your siteseed installation. The only exception are siteseed system directories (e.g. bo).


$ifcontent$ Macro The new $ifcontent$ macro allows to create dynamic layouts depending on content of article fields.


FCK Editor FCK Editor (http://www.fredck.com/FCKeditor/) is now available as Siteseed Module and can be used to replace the current visual editor. It's an external module, because it's licenced under the GNU Lesser General Public Licence (LGPL).


$php$ Macro The $php$ macro allows to execute PHP code in layouts. A set of PHP macro functions allows to access data of all other conventional macros quite easily.


Component Types The current siteseed release offers features not yet covered by the official documentation. One of these features are component types. They e.g. extend comon editor fields by predefined default content and a lot of other things.


Sitelib Documentation Sitelib is a library that encapsulates code that is often used in siteseed interfaces. This includes mainly database queries in order to achieve a higher level of abstraction and to be more independent of possible database changes in the future. This article explains all library functions and provides examples for their proper usage.


About Us | Site Map | Privacy Policy | Contact Us | © 2004 Siteseed.de
Siteseed is a trademark of Mr.Net - Serviços Informáticos, Lda