# Administration

## Directory structure

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

- The /admin Directory contains the editors as well as the processing and storage scripts.
- In the directory /settings are the configuration files.
- The directory /content and all subdirectories and files must be writable, CHMOD set according to the data of the provider. In /content contains all of the administration of editable files.
- In /includes are a few basic extensions stored, the (more or less) to work directly with the administration.
- The directory /modules is the place for your own extensions.

## 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 content="text/html; charset=utf-8" http-equiv="content-type" />

### Doctype XHTML Transitional

The Webutler and the editors are preset for the display mode of XHTML Transitional.
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
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. HTML 5 is not supported (yet).

### 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 XHTML 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 umlauts or slashes)
   - 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 umlauts.