Administration

Directory structure

The system is mostly file-based. For user management and for some modules, the server must support SQLite3.

Integrate existing HTML pages

The world speaks UTF-8

Both the Webutler and the CKEditor work with the Unicode character set. So there are no problems with umlauts or other special characters, any files that were not created with the Webutler are stored in UTF-8. Two things to watch for:

  1. The files themselves must be saved as "UTF-8 without BOM". To do this, of course, must use a Unicode-enabled editor, such as Notepad++ or PSPad.
  2. The charset specified in the header of the file must be customized:
    <meta charset="utf-8" />

HTML5 Doctype

The Webutler and the editors are based on the display mode of HTML5.
<!DOCTYPE html>
Who has created websites in HTML 4 or in quirks mode (no doctype) they should first switch to XHTML Transitional to go sudden changes in the presentation of the way.

Adapt / change pages

Ready HTML pages can be quite problematic to insert in the Webutler. All preparations should be made locally. That they are in UTF-8 and HTML5 is assuming at this point. The following adjustments are necessary:

  1. copy your CSS files after /content/style
  2. copy your javascripts after /includes/javascript
  3. copy images and other embedded media into the appropriate subdirectories of /content/media
  4. Open your HTML pages
    • adjust the paths to the CSS, JavaScript and media files (possibly also need to be adapted paths in the files themselves)
    • replace all the links to your pages: from FILENAME.html wird index.php?page=FILENAME
    • File names can only consist of letters, digits and the underscore character (no dashes or special characters)
    • save all pages without file extension in /content/pages
    • Subdirectories can be simulated with the categories (Infos)

In addition, the following changes that facilitate the maintenance of the website much be made. Who would not want to use this option, the setting should $webutler_config['fullpageedit'] set in the file "/settings/globalvars.php" to "1".

  1. In the HTML source code placeholder for menus, blocks, and editable regions can be set.
    • open your pages /content/pages
    • cut out the menus from your pages and save them in the folder /content/menus
    • Header and / or Footerzeilen can also be cut and stored in /content/blocks
    • replace the placeholder (comments) for the menus and blocks (Infos)
    • put to the comments for editable regions (Infos)
    • put the classes "wb_menuelement", "wb_blockelement", "wb_contentelement" and possibly "wb_gridelement" (Infos)
  2. all file names in /menus /blocks and /pages need to be stored without extension
  3. copy pages with different layouts of /pages to /layouts
    • Remove all content between <!-- begin_content --> and <!-- end_content -->
    • save the page as LAYOUTNAME.tpl

That's it, now all the web space and the page should work. If not, again exactly control all the points. If all the paths and file names? File names can not contain spaces, dashes or special characters.