User guide
Table of Contents
Back end settings
Once you have installed TYPOlight you should check the system settings. To do so, open the settings module. The changes you make here will be saved in the local configuration file system/config/localconfig.php. You can also edit this file manually if for some reason you cannot access the back end anymore.
Relative path to the TYPOlight directory
This parameter is usually set automatically. If front end and back end are configured correctly, you should not have to worry about this value. If you have installed TYPOlight in the root directory of your webserver, this parameter remains empty anyway. However, if you experience display errors, or if front end URLs are being rewritten, you should check this parameter.
The relative path is built from the TYPOlight root directory as seen by your browser. For example, if you access TYPOlight using the following URL:
http://www.your-domain.com/TYPOlight_webCMS_2.1/
the relative path would be:
/TYPOlight_webCMS_2.1
File upload settings
TYPOlight includes a built-in file manager that allows to upload files to your server as well as to move, rename and delete them. By default, the file manager uses folder tl_files as its root directory. You can specify another directory if you want. As an administrator you can also specify the maximum file size (in bytes) and the maximum width and height (in pixels) for images.
Use SMTP to send mails
By default TYPOlight uses the PHP function mail() to send e-mails. Here you can choose to use an SMTP server instead. After checking the corresponding check box TYPOlight should automatically load additional input fields where you can enter your SMTP login details.
TYPOlight uses AJAX to load additional input fields. Therefore, JavaScript should be enabled. Otherwise, you will have to save your changes to have the additional fields appear on the page. Click the "Save" button or use the hotkey [ALT] + S to do this. It is recommended to turn on JavaScript in your browser.
Use FTP to modify files
If you are running PHP as module TYPOlight might not be allowed to modify files due to safe_mode restrictions or missing file permissions. In this case you can either set the file mode (CHMOD) of the TYPOlight root folder to 777 (not recommended) or enter your FTP server login details to make TYPOlight access files via FTP.
Upon a new installation you might have to enter the FTP login details manually in the local configuration file.
Storage time and session timeout
Storage time and session timeout are measured in seconds. You can define how long deleted records or different versions of a record will be kept, after which period of time a user session will time out and how long user accounts remain locked if there were more than three unsuccessful login attempts.
Custom layout sections
By default, TYPOlight divides a page into up to five sections, a header and footer section and up to three columns in the main area. You will learn how to create and modify a page layout in one of the following chapters.
In addition to these default sections you can define custom layout sections to create individual page layouts. Custom layout sections are usually positioned after the default sections but can be positioned freely by changing the template file.
Maximum front end image width
To prevent oversized images from having a negative impact on your website layout, you can define a maximum image width in pixels. If a back end user tries to assign a greater width to an image, it will automatically be adjusted to the maximum image width minus the padding. Leave the field empty to turn off automatic adjustments.
Valid image file types
TYPOlight comes with a built-in image manager which resizes images automatically and crops them if necessary. The image manager is based on the PHP extension GDLib, which supports JPG (.jpg, .jpeg), GIF (.gif) and PNG (.png) formats. For these image file types the file manager automatically generates thumbnail images. You can use the file manager in your own scripts like this:
<img src="image.php?src=tl_files/image.jpg&width=200&height=120" />
If you want to use you own script to manage images or if you want to exclude certain file types from being manipulated by the image manager, you can change the list of image file types to fit your needs.
Valid download file types
TYPOlight comes with a built-in download manager providing detailed control over file downloads thanks to an intelligent token system. Thus, you can exactly define who is allowed to download a file and who is not. For security reasons, file downloads are limited to the files directory and to certain file types which can be defined here.
Rewrite front end URLs
A popular and very effective measure in the course of search engine optimization is simulating static pages. Thereby, a dynamic page is called in the browser as if it was a static page. TYPOlight generates static URLs by default, e.g.
http://www.your-domain.com/index.php/home.html
instead of the actual dynamic URL
http://www.your-domain.com/index.php?id=home
If usage of Apache's mod_rewrite is permitted on your server, you can additionally remove the index.php fragment from the URL and call your website like this:
http://www.your-domain.com/home.html
The advantage of this static URL is that most search engines will presume a static HTML page here which will be given a higher page rank than a dynamic page.
There is a file named ._htaccess in the root directory of your TYPOlight installation. This file contains all necessary commands to enable URL rewriting. Simply rename it to .htaccess and enable option "Rewrite URLs" in the back end settings.
If your website is located in a folder on the domain, such as:
http://www.your-domain.com/folder/
you will need to change the second line of the .htaccess file to be:
RewriteBase /folder
Attachments
-
layout-sections.gif
(2.8 KB) - added by leo
5 months ago.
Layout sections
