- Check your installation by calling the info.php. If the gallery does not start please check the rights of the directories 'cache', 'counter' and 'xml' (if present). Change them to 777 (chmod 777). Check the how-to 1 for better security settings! From version 1.4.3 on the XML files can be stored stored in the album directories. Please read howto 35 for details! Howto 53 shows how to configure your server properly.
- Log into the TWG administration and change the default password:
- Login to the TWG backend (admin/index.php or use the login in the menu and click on 'Administration' after the login).
User: admin
Password: twg_admin
You have to change the default password! If the user file (admin/_config/.htusers.php) is not writeable please change the permission with your FTP program. Check the info page in the admin area! - To use the Upload Flash you maybe have to copy a .htaccess file to the directory of the upload flash (admin/upload). The file is stored in a zip in this directory. Simply try the Upload Flash (Use Upload in the TWGXplorer). It will tell you if you need to extract the .htaccess file. Please go to the TWG Flash Uploader section of the website for more support.
- Read how-to 30! Many problems why you cannot upload or something does not work are explained there!
- Login to the TWG backend (admin/index.php or use the login in the menu and click on 'Administration' after the login).
- Now you can start to configure TWG:
- TWG Admin:
You can set all important parameters under 'Configuration' in the TWG Admin. Most of the options there can be even be configured in more detail. The description can be found in the config.php or below. You can add this parameters in the additional tab. You can change the colors of TWG with the Color Manager. Simply select a color and click on on of the areas on the right side. Then you can create a style sheet and save it as your new style! The Color Manager does always a backup of your my_style.css. You should delete old styles if you don't need them anymore. Please note that your current style cannot be loaded! Transparent is a color too! The background images are only for demonstration. Please read how-to 9 how to add backgrounds to TWG. - Manual:
TWG has two config files. my_config.php and config.php. my_config.php has the main settings for TWG and config.php has all possible parameters. If you want to config TWG in more detail go to the config.php and look for the settings you want to change. Store the new settings in the my_config.php. If you want to change the colors of TWG you can use the Color Manager and store the style sheet in my_style.css. Most style settings can be found in the style.css. Store changes in my_style.css.
If you store your settings in the my_* files it makes it easier to update TWG! All parameters are described on the website too (see below)! - Copy the folders of your pictures into the 'picture' directory. The directory name is the name of the gallery (see how-tos for changing this). If you are done with setting up galleries: Set $cache_dirs to true to enable session caching!
- You can change the default title of the gallery in the config (my_config.php or TWG Admin)! You can set the title for each language in the language/language_<language>.php file at $lang_titel. If you want to remove some languages - just remove them from the language directory. If you want to remove the language selector completely please remove all languages execpt the one you like as default.
- Read the how-to's. There are many things to configure TWG even better.
- New TWG 1.8.8: Since this version a optimized .htaccess is coming with the download which enables compression and caching of the web server. If you have an Apache web server I recommend to use this file by simply unzipping the htaccess.zip. Furthermore all css files a dynamically combined and compressed. the compress css files is stored in the cache folder for one day. You can disable this optimization during setup by setting $optimize_css = false; or you can delete this file by clearing the session cache (in the administration or by clicking on the bandwidth icon. The optimization has up to 42% less requests and up to 55% less bytes are transfered. You find details about this in the blog or and in the howto about optimizing TWG.
- TWG Admin:
Please do use TWG Admin OR manuall configuration! TWG Admin does use the my_config.php as well to store the data. If you make settings in my_config.php and you use TWG Admin later to configure TWG your settings are overwritten.
Please note: TWG is storing data like captions, comments or tags in xml files in the xml folder. If you want to move or rename folders please read how-to 35 first!
Configuration with the config.php
The important settings can be set in the in the TWG Admin.
The remaining configurations can be done in the config.php. Copy the one you want to change to my_config.php or to the "Additional" tab in the TWG Admin. Most of the settings don't have to be changed - but feel free to adapt the gallery to your needs :).
New parameters in 1.7 and 1.8
All new parameters in 1.7 and 1.8 can be found at the bottom in config.php. The best way to get an overview of the many parameters you see there is using full text search (even I do this). If you have a basic idea what to search for - do it. If you want to configure the tags - search for 'tag'. The parameters all pretty much explain themselves.
The config file is nicely structured too. Look for the sections first and then you don't have that many options anymore (maybe only 50 ;).)
I will update the web site when I have some more time.
New parameters in 1.6
They are not ordered right now - only in the order of the appearance. I wanted to make a small overview for people whe already worked with 1.5.x.
| $autogenerate_private_png | (true/false) New 1.6 - true : password protected galleries shows the 1st image with a lock on it - false: only the lock is displayed! - if you want to use your own: use private.png - the generated images are stored in the cache with the prefix pi_ |
| $metadescription | (String) New 1.6 - You can add the content of an individual metatag description here. Separte the entries with an ',' . Makes your gallery better to find in the web - metatags are only generated if (true/false) New in 1.2 - This has to be set to true if you include (with include ....) - see the settings below !! =false If nothing is provided the default TWG metatag description is used! |
| $use_resized_background | (true/false) New 1.6 - There are two ways to use dynamic background - by resizing on the client in an extra div (false) or by resizing the background on the server (true). Resizing on the client is the old mode used before 1.5 where the image was exaclty resized to the browser but the problem was that the motions gallery was not working very good anymore and therefore I implemented the no scrolling cmtion option. Since 1.6 it is possible to get a resized background from the server where no restrictions to the cmotion gallery does exist - it only used a little bit more space in the cache ;). true should be default because this mode is optimized for speed and server load |
| $resized_background_tolerance | (Number) New 1.6 - the new use_resized_background mode is not generating backgrounds for every resolution. It is generating it in step of this setting. If e.g. your browser needs an image with 950 width then the next bigger avalable image is used (for resized_background_tolerance = 100 this would be 1000). The smaller the number is the better does the backround fit but the more space you need ;). |
| $other_file_formats_previews | (Array) New 1.6 - You can specify images that are used by the TWG Admin when generating preview images for other filetypes. You don't have to provide a preview image anymore - simply create a default! |
| $mixed_video_image_content | (true/false) New 1.6 - You can have one type of video and images in one folder! This only works in the HTML and HTML_SIDE mode - If you set this to true then DHTML mode is switched to HTML mode! Therefore I recommend to set this to true this ONLY in the video.php! if you set this to true you have too add v___ (3x _) at the front of the filename of the video - this prefix is removed when a caption is displayed! e.g. 123345.jpg -> v___123345.jpg - a sorting prefix goed BEFORE this 123345.jpg -> 123___v___123345.jpg |
| $big_nav_pos | (String) New 1.6 - valid entries are 'top' and 'bottom' - Displayed the thumb strip above or below the main image |
| $show_first_last_at_autoswitch | (true/false) New 1.6 - If nonscrolling thumbs strip is used you can specify if the first last buttons are shown automatically to indicate that is is possible to scroll. When a dynamic background is used this makes sense because the switch is done automatically by TWG and then the arrows are shown too if set to true! |
| $open_in_maximized_view | (true/false) New 1.5.4 - opens the image in the maximized view as it can be done in the menu - (true/false) New 1.3 - should be true if open in browser is true because the dhtml jumps back to the initial image and not to he last! and open_as_popup are ignored! |
| $click_on_popup_dl_image | (true/false) New 1.6 - you can enable that you download the image if you click on it in the popup - if false you close the popup |
| $show_iptc_data | (true/false) New 1.6 - Shows the available iptc data in the info panel - the tags that are displayed are defined in the language file ($ lang_iptc_info)! only existing ones are shown! |
| $preselect_tags_search | (true/false) New 1.6 - Preselect the tags checkbox in the search window |
| $image_file_is_multi | (true/false) New 1.6 - if you set this to false the whole text in the image.txt or image.php is treated as one text block that is processed/included. If you set this to true then each line is parsed like a properties files and you can define one line for each image that is displayed! (like the caption but this is more powerfull because you can use full html code) - see howto 28 - the part of 1.6! |
| $show_tags | (true/false) New 1.6 - Show the top tags - the search for tags and the posiblility to enter tags at the detail page when logged in. |
| $number_of_top_tags | (Number) New 1.6 - Number of maximum entries that are shown in the top tags iframe |
| $number_of_top_tags_results | (Number) New 1.6 - Number of results that are shown in the search for a tag after selecting it in the top tags iframe |
| $use_iptc_tags | (true/false) New 1.6 - you can allow the reading of iptc data in general - if false the data from images are not read |
| $iptc_fields_for_imagetags | (Array) New 1.6 - IPTC offsets that are used for image tags - right now: keywords |
| $iptc_fields_for_dirtags | (Array) New 1.6 - IPTC offsets that are used for album tags - right now: sub-categories |
| $iptc_fields_for_caption | (Array) New 1.6 - IPTC offsets that are used for the caption when captions are extracted in TWG Admin or after the upload |
| $exif_field_for_caption | (String) New 1.6 - Exif field that are used for the caption when captions are extracted in TWG Admin or after the upload. Only used if no IPTC data is found! By default this is empty because it is really slow. e.g. Image Description is often stored at 'imageDesc' - Please read howto 38 for more details. |
| $add_iptc_at_upload | (true/false) New 1.6 - Extract the IPTC data (tags and caption) and stores it in the xml file during upload with the TWG upload flash - for html bakckup it is not implemented - you have to use the 'Exctact IPTC data' function in TWG Admin then. |
| $enable_frontend_upload | (true/false) New 1.6 - You can enable/disable the upload in the frontend. You have to enable this AND create users in the backend that have the permission to upload in the frontend! |
| $use_login_short_menu | (true/false) New 1.6 - If you are logged in you get a couple of more entries in the menu. To keep your layout the fixed menu items can be displayed shorter (!st letter and a . Info -> I.) if you set this to true. |
| $show_wii_buttons | (true/false) New 1.6 - You can show big control buttons for the wii - but you don't have to because the left right on the wii controll is supported too ;). try it ;). If you use small_pic_size = 400 then the image fit nicely on a tv! |
| $enable_album_tree | (true/false) New 1.6 - You can display an explorer like album tree on the left side - this is a bonus feature for registered users :). |
| $album_tree_default_open | (true/false) New 1.6 - Shows/hides the tree when you open the gallery. |
| $autoclose_tree | (true/false) New 1.6 - You can make the tree autoclose by default if you click on it. Otherwise it stays open until you close it - you can change this behavior by the small marker in the right upper corner of the tree. Opera has a display bug here - therefore this is disabled - you have to close the tree manually! |
| $album_tree_width | (Number) New 1.6 - The width of the album tree. |
| $admin_default_upload_method | (String) New 1.6 - You can set the default upload method of the admin. valid values: 'flash' or 'html'. html disables the menu items 'upload images' and 'File Split Applet' |
| $admin_nr_uploads | (Number) New 1.6 - Defines the number of lines in the html upload form |
| $admin_default_simple_view | (String) New 1.6 - The default view of the TWGXploerer. valid values: 'yes |
| $admin_enable_split | (true/false) New 1.6 - Enable/disable the file split capabilities of TWG to get around a upload limit. Please read the howto 42 about the split test before enabling file splitting. |
| $admin_file_split_is_tested | (true/false) New 1.6 - Spliting and merging big files is not supported by all servers. Therefore this is disabled by default. Please read the howto 42 about the split test before enabling file splitting. |
| $admin_allowed_file_extensions | (String) N new 1.6 - The allowed file extensions for the upload flash! jpg,jpeg,gif,png are allowed by default. 'all' allowes all types - this list is the supported files in the browse dropdown! |
| $admin_user_allowed_file_extensions | (String) New 1.6 - The allowed file extensions for the upload flash in the frontend! forbidden is the same as for the backend. |
| $admin_forbidden_file_extensions | (String) New 1.6 - The list of forbidden file extensions! - only usefull if you use 'all' and you want to skip some exensions! |
| $admin_hide_help_button | (true/false) New 1.6 - Since TFU 2.5 it is possible to turn off the ? (no extra flash like before is needed anymore!) - the switch is triggered by the license file! See website of TFU for details. You need at least the registration without the ? to hide the ? on the flash. This is maybe interesting for admins who enable upload with the front end and want eben the flash anonymous. |
| $enable_ie_filename_fix | (true/false) New 1.6 - shows the right file name in ie when you use 'save as..' - but you loose the browser caching - show pictures are loaded from the server again and again - decide what you want - save as or a faster gallery! |
| $allowed_html_tags | (Array) New 1.6 - allowed html tags in comments and titles ! |
| $allow_all_html_captions | (true/false) New 1.6 - You can allow to enter everything for captions! All html - simply everything! - This is false be default to protect your gallery! if true scripts could be executed on your server if someone has the right to enter captions - only set this to true if you trust ALL of your users that are allowed to enter captions!!! |
| $disable_right_click | (true/false) New 1.6 - you can disable the righclick in the gallery to protect your images - but if people turn off Javascript they can still copy - only usefully for dau's |
Personal settings
Settings you should adapt to your website. The title "Welcome to the TinyWebGallery" is language dependent and stored in the language files - Please change it too!
| $default_language | (String) The gallery is started with this language if no language from the browser can be read. To add a new language you have to translate one of the existing languagefile (e. g. language/language_de.php - the name of the needed flag is language/language_de.gif) and copy it in the 'language' directory (+ the flag). If you provide a file language/language_<lang>.txt you can specify the tool tip. Please write the language in English and then in the language of the country in Brackets e.g. Germany (Deutschland). If you need a flag - please send me an e-mail. Please send me the language files if you want to support TWG. Please make sure to use the latest version of TWG and 'Welcome to the TinyWebGallery' as title. |
| $titelpasswort | (String) The password used for entering titles, delete comments and rotation images permanently. |
| $privatepassword | (String) To protect a gallery with a password you have to create a empty file with the name 'private' in the directory you want to protect. If you want to protect a gallery with a different password you have to enter the password in the 'private' file. |
| $enable_external_privategal_login | (true/false) New 1.2 - enables/disables to login a private gallery with a password - the password has to be added as parameter twg_private_login=password. The password is the plain password! - when the administration is available I will add a kind of encryption. |
| $browser_title_prefix | (String) This is the title which is shown in the browser title - you may change this to the name of your gallery |
| $default_gallery_title | (true/false) New 1.3 This is the default title shown on the main page if no real lang_titel is specified in the language file. If you want to have different titles for a language please adapt the language files! |
| $encrypt_passwords | (true/false) New 1.2 - enable/disable encryption of passwords! - if you change this to true you have to generate your passwords with the provided password.php. Sha256 is used for the encryption. Passwords titelpasswort and adminpasswort are NOT encrypted!! only privatepasswort!! see password_file and the how-to for more infos!! TWG has a password.php where you can generate your passwords! |
| $metatags | (String) New 1.3 - You can add the content of an individual metatag here. separte the entries with an ',' . Makes your gallery better to find in the web - metatags are only generated if $php_include=false |
Directories
In this section you can adapt all the directories - normally there is no need to change something here. Make sure to set the permissions correctly
(if you want to include the index.php read the description behind $install_dir).
| $iframe_include | (true/false) New 1.4 - When you include your galerie in an iframe set this to true - if not included a different doctype is used that does better layouting for ie - if included the doctype has to be changed to avoid the reserved right border for the scrollbar. ie does not show all hover effects anymore if you set this to true! |
| $php_include | (true/false) New in 1.2 - This has to be set to true if you include (with include ....) - see the settings below !! |
| $install_dir | (String) New 1.2 - This is only needed if you include (with include ....) twg with php into an existing php page and twg is in a subdirectory! you have to enter the path from your including page to the twg installation e.g. 'TinyWebGallery/'. The / at the end is needed! |
| $ignore_parameter | (Array) New 1.2 - Some parameters are not wanted to be added to all twg links - (e.g. cmsphp - file parameter) - make an array with the parameters here ! |
| $disable_frame_adjustment_ie | (true/false) New 1.3 - ie has a bug in i_frame adjustment! - if you integrate twg and the i_frames are all right in ff but totally rearanged in ie set this to true! |
| $basedir | (String) This is the directory where the directories with the images has to be copied. |
| $cachedir | (String) This is the directory where all generated images are cached. This directory has to be made read- and writeable on the web server. |
| $counterdir | (String) This is the directory where all the counter data is stored. This directory has to be made read- and writeable on the web server. |
| $xmldir | (String) This is the directory where all xml files for titles and comments are stored. This directory has to be made read- and writeable on the web server. |
Skin settings
In this section are the settings to activate a skin - Here are the default settings for the gallery. A skin does most of the time overwrite the next settings! A skin can also set non visual settings to - but it is not recommended to do this! Read the Skins how-to if you want to share your gallery layout with others.
| $skin | (String) New 1.3c - As default no skin is used - in the download are 'black','green','transparent','winter' and 'newyork'. All other style settings are still valid (check how-to 9). Some of the skin have a background! Check the Skins how-to to create your own skin or look in the forum of TWG - there is a skins section. If you change the skin you have to delete the *.slide.jpg images in the cache folder! |
| $background_default_image | (String) New 1.3c - Normally you put the background in the stylesheet or as back.png in the image folder! but if you want to use a dynamic background the image has to be defined here - skins overwrite this setting if they have a background image. |
| $use_dynamic_background | (true/false) New 1.3c - If you want a dynamic background that resizes with the browser size you have to set this to true and set a $background_default_image - skins overwrite this setting if they have a background image. |
| $resize_only_if_too_small | (true/false) New 1.3c - If you have this to true the image is not made smaller than the original its only made bigger - if false it is resized all the time! |
$slideshow_backcolor_R |
(Number) Background color of the slideshow images - enter the RBG value as decimal value. |
| $comment_corner_size | (Number) When an image has a comment the right upper corner is make white. This value determines the size of this corner. |
$comment_corner_backcolor_R |
(Number) New 1.2 this are the colors of the comment corner (RGB value in decimal) |
| $enable_drop_shadow | (true/false) New 1.3 - you can enable/disable the default border of the image - there is a drop shadow defined in style.css -> div.twg_img-shadow - This looks very good if you have bright backgrounds if not - don't use it ;) |
Sizes
In this section you can set image sizes, number of images displayed on each page ...
| $menu_x | (Number) Number of galleries which are shown in a row on the overview page. |
| $menu_y | (Number) Number of galleries which are shown in a column on the overview page. |
| $hidemenuborder | (true/false) New 1.3c - Shows or hides the menu border - is not done in the sylesheet because the style is used more often. |
| $autodetect_maximum_thumbnails | (true/false) New 1.2 - twg tries to display as much thumbnails as possible without creating scrollbars - is turned off in low bandwith mode! |
| $thumbnails_x | (Number) Number of images in a row on the thumbnail page. |
| $thumbnails_y | (Number) Number of images in a column on the thumbnail page. |
| $number_top10 | (Number) Number of images that are shown in the top views page - The existing calculation (13) works nice with the existing layout. |
| $small_pic_size | (Number) max. size of the web images. |
| $resize_only_if_too_big | (true/false) New 1.3 - If images are equal or smaller they are not resized if true. You can save disk space if you set this to true and resize all pictures with an external program before uploading |
| $use_small_pic_size_as_height | (true/false) The small pic size restricts the picture to a maximum height and width of small_pic_size - therefore vertical and horizontal images have the same maximum side length. If you set this switch to true the size is used as maximum height. vertical images are then smaller then horizontal - but when you watch the images the navigation does not jump to the bottom if a vertical image is coming - If you use this parameter please decrease the picture size by ~1/3 to get the horizontal images in the same size as before (and delete the cache!!). |
| $maxXSize | (Number) New 1.2 - If you have panorama images you can restrict the maximum width of an image - $use_small_pic_size_as_height has to be true that this restriction is needed! A panorama is assumed if the width/height > 1.5! |
| $thumb_pic_size | (Number) max. size of the thumbnails. |
| $strip_thumb_pic_size | (Number) New 1.5 - You can show the thumbs for the big navigation in a different size then on the thumbnail page! Does only work if clipped images are used. |
| $menu_pic_size_x | (Number) width of the gallery overview pictures - has to be dividable by 2. |
| $menu_pic_size_y | (Number) height of the gallery overview pictures - has to be dividable by 2. |
| $compression | (Number) compression of the generated images. 80 is a good value. Generates thumbnails (size 100) of ~ 4k. Generates web images (size 480) of ~ 33k |
| $compression_thumb | (Number) New 1.3 - quality of the generated thumbnail jpegs - best = 100 - but biggest size !! I make them better quality because they are really small |
| $show_clipped_images | (true/false) clipped images in the thumbnail view - all images will be shown as squares - if you change this - delete all thumbnails in the cache!!! The size of the images (x and y) will be $thumb_pic_size! remember - all thumbnails are squares then on the detail page you cannot see if a image is horizontal or vertical. |
| $center_clipped_images_horizontal | (true/false) New 1.3 - center clipped images horizontal if true |
| $center_clipped_images_vertical | (true/false) New 1.3 - center clipped images vertical if true |
| $show_colage | (true/false) true: Shows a collage of the first four images, false: 1st image of directory is shown. |
| $use_random_image_for_folder | (true/false) New 1.2 - if true a random image of this folder is picked for the collage or the image which is shown in a folder icon. |
| $show_languages_as_dropdown | (true/false) New 1.2 - show language flags or as a kind of dropdown. |
| $folder_effect | (String) New 1.4 - there are 3 effects for the main gallery view 'fade', 'gray' and 'change' (change the images with another from the directory on mouseover!) - if you don't want an effect use '' or 'none' - this effects looks best under ie - ff does some flickering in modus fade! - gray only works for ie (fade effect in ff as backup) - fade only for ie and ff - change for all browsers! |
| $fading_level | (Number) New 1.4 - this is the level a picure is blured - 100 is max visibility! |
| $gray_fading_level | (Number) New 1.4 - gray is only available for ie - other browsers fade with this setting. |
| $fade_all | (true/false) New 1.4 - normaly only the image over the mouse is changed - if you set this to true all images of the collage are changed. |
| $use_random_image_for_change | (true/false) New 1.4 - if true a random image from the folder is used for switching - if false the one from the colage is used |
| $other_file_formats | (Array) New 1.4 - other file formats that can be downloaded - the ist parameter is the extension, the 2nd is the watermark image - If you don't like a watermark please use the wm_none.png file. The downloads are direct downloads - if it does not work check if the directory or filename conain special characters ... |
| $show_other_formats_at_thumb | (true/false) New 1.4.1 - Other formats are opend on the thumbs page in a new window if you set this to true! |
| $watermark_position | (Number) New 1.4 - you can define the location of the watermark with this setting (top: 1 2 3, middle: 4 5 6, bottom: 7 8 9 |
| $watermark_transparency | (Number) New 1.4 - you can also set the transparency of your watermark. 0 is no transparency - 100 max; Try your logo with different settings to get best results. |
Video
Here you can set the default settings for the embedded video support of TWG!
Please read the howto 34 how to setup video support and use different settings for different folders!
| $show_videos | (true/false) New 1.5 - This setting is modified in the low settings mode - by default videos are disabled if low bandwith is detected |
| $video_size_x | (Number) New 1.5 - The is the default width of the embedded video. |
| $video_size_y | (Number) New 1.5 - This is the default height of the embedded video. |
| $video_player | (String) New 1.5 - support for 'WMP' = windows media player, 'DIVX' = Divxplayer plugin for streaming divx, 'FLASH' = flash player, 'GOOGLE' for video.google.com , 'MP3' for a flash mp3 player read the howto for video support!!! |
| $video_autostart | (true/false) New 1.5 - enabled the autostart of the videos |
| $video_show_dl_link | (true/false) New 1.5 - Show the download link below the video - should only be enabled if you have local videos - if you use FLASH or GOOGLE this has to be disabled |
| $video_flash_site | (String) New 1.5 - The prefix of flash sites - tested is 'http://www.youtube.com', 'http://www.dailymotion.com' and 'http://www.myvideo.de' maybe other video sites work too - please tell me if you find another site that works! |
| $video_autostart_parameter | (String) New 1.5 - This is the extension you have to add after the link to enable autoplay - his is different for youtube and dailymotion - please read the howto 34 for more details |
Default URL settings
In this section you can set some default settings which can be changed by the user or by url
| $show_only_small_navigation | (String) New 1.2 - default if only the small navigation is shown. 'TRUE' shows only the small navigation |
| $disable_nav_sel | (true/false) New 1.4 - You can disable the option that someone can enable/disable the big navigation. |
| $default_big_navigation | (String) there are two type of Big Navigation - normal (HTML ) and dhtml (DHTML) - The dhtml version does a lot of preloading - Please do not use this if your expected users don't have fast connections |
| $autodetect_noscoll | (true/false) New 1.5 - if you have less then (Number) New 1.3 - x * 2 +1 = number of pictures that are displayed in the thumbnail strip off the image page - only 1 and 2 are valid !! images you don't need to scroll at all - if you set this to true the thumbs below are static no mater which one you select (the actual thumb in not below the image anymore!) |
| $use_nonscrolling_dhtml | (true/false) New 1.5 - if you set this to true the dhtml thumbsbar is not scrolling anymore - it is simply moving when you click on an thumbs - it looks like the html solution but is much faster - The reason I implemented thisis because if you use $use_dynamic_background=true the scroller does work pretty bad - therefore if you set $use_dynamic_background to true automatically the option is set to true! |
| $numberofpics | (Number) New 1.3 - x * 2 +1 = number of pictures that are displayed in the thumbnail strip off the image page - only 1 and 2 are valid !! |
| $numberofpics_html_side | (Number) New 1.4 - If you switch to the html side mode another number of preview images sometimes make sense - 9 means 4 on each side |
| $disable_nav_big_sel | (true/false) New 1.4 - You can disable the selection of another big navigation - especially if you have a layout that would be killed by another navigation! |
| $html_side_break | (Number) New 1.4 - This is for HTML_SIDE only. you can specifiy after how many images are in one row. if you show e.g. 4 images on ech side you can set this to 2 which shows an 2x2 block - if you set this to 1 you have all thumbs in one column. |
| $html_side_space_optimization | (true/false) New 1.4 - if you set this to true and select the 1st image still images are shown on the left side - if false no images would be on the left side if the 1st is selected - same for the end! if you have 8 images a special treatment is used - the images are static and you can always selct one of the 8 thumbnails. |
| $html_side_show_dividor | (true/false) New 1.4 - if html_side_space_optimization is true and you e.g. click on the 2nd image the 1st thumbnail is shown and after wards the 3rd 4th and 5th on the left side - the dividor is added between the thumb of image 1 and 3 the show the user where the image belogn in the order. if set to false this dividor is not shown. |
| $show_slideshow | (true/false) New 1.3 - Enables / disables the slideshow functionality of TWG |
| $twg_slide_type | (String) Defines the default slideshow type - 'TRUE' is the cross fade version, 'FALSE' the normal version, 'FULL' the maximized version! |
| $show_optimized_slideshow | (true/false) New 1.3 - Shows/hides the optimized slideshow option in the options menu - if true: $twg_slide_type should not be 'TRUE'! |
| $show_maximized_slideshow | (true/false) New 1.3 - Shows/hides the maximized slidshow option in the options menu - if true: $twg_slide_type should not be 'TRUE'! |
| $twg_slideshow_time | (String e.g. '10') Defines the default slide show interval. |
| $show_border | (String) New 1.2 - By default there is a border around TWG. If you integrate TWG is most of the time looks nicer if the left,right and bottom border are removed. This value can be set with url parameters too (twg_withborder=true or twg_noborder=true). This setting is cached in the session. You have to close all browser to see the changes!. Valid values 'TRUE' and 'FALSE'; |
| $enable_maximized_view | (true/false) New 1.3 - = fullscreen modus -- This modus is intended for people who want to show their images like in a slideshow but with manual navigation. The images are not cached in this modus because they can get very big! |
| $default_is_fullscreen | (true/false) New 1.3 - default is started in full screen - Should be false as default and only be set to true with the options |
| $show_warning_message_at_maximized_view | (true/false) New 1.2 - enable/disable a JavaScript warning that tells the user that switching to the maximized view is quite slow ;). |
| $show_caption_at_maximized_view | (true/false) New 1.3 - show the caption in full screen modus at the bottom |
Main features
In this section you can enable or disable main features of TWG.
| $show_comments | (true/false) Enables comments (Enter, Display). |
| $show_comments_menue | (true/false) New 1.4 - you can disable the entry in the menu - but still enter it at the bottom - see $show_enter_comment_at_bottom |
| $show_enter_comment_at_bottom | (true/false) New 1.2 - shows the comment link additionally below the picture! |
| $show_number_of_comments | (true/false) New 1.3 - Show the number of entered comments next to the comment text |
| $show_comments_in_layer | (true/false) New 1.3 - Show the comments in a big layer instead below image - makes a nicer layout! |
| $height_of_comment_layer | (Number) New 1.3 - The additional height of the layer where the comments are shown. |
| $show_number_of_pic | (true/false) show the number of images in a gallery in the overview. |
| $show_count_views | (true/false) TWG shows the views counter in the right corner in the details view - This is quite slow because it has to read and write the counter xml-file every time. |
| $show_login | (true/false) New 1.2 - enables/disables the login button in the right upper corner |
| $show_captions | (true/false) New 1.4 - you can hide the menu element to enter a caption. |
| $show_optionen | (true/false) New 1.2 - enables/disables the options button in the right upper corner on the details page |
| $show_new_window | (true/false) New 1.2 - enables/disables the 'new window' button in the right upper corner and in the options pane. |
| $new_window_x $new_window_y |
(Number) The size of the new window - this setting work nice for the actual settings - please change them if you change the image sizes (Number or 'auto') New 1.2 if you enter 'auto' at this point for both values it is resized to the maximum your screen can do ;) |
| $enable_download | (true/false) enable download of original files. If you don't want that the people can download set this parameter to false. |
| $enable_download_counter | (true/false) New 1.3 - Enables the counting of download of an image - $enable_direct_download has to be se to false |
| $enable_direct_download | (true/false) New 1.2 - does only work with $enable_download=true - you can select if the original images are linked directly or if a call goes to a php page which returns the image. true: shows the image in the browser and it's easy for someone to go to your image directory and browse even into protected folders - please don't use this if you have protected galleries false: shows a download window where you can save the image. This is much saver but people with slow connections have sometimes problems downloading properly (reported by some users - therefore I added the direct download) - please test on your system if the recommended 'false' setting work! Attention: if your filename does contains characters like äöü... you get a 'you don't have permissions' warning on my windows system please don't use this characters if you using direct download - thanks |
| $open_download_in_browser | (true/false) New 1.2 - Opens the original file as download or in the browser: true: in the browser; false as download |
| $open_download_in_new_window | (true/false) New 1.3 - should be true if open in browser is true because the dhtml jumps back to the initial image and not to he last! |
| $open_as_popup | (true/false) New 1.4 - true: opens the new window as popup - false: opens the new window as new browser - works for direct download as well! |
| $show_rotation_buttons | (true/false) show the rotation buttons on the details page; true - shows them; false - hides them. TWG does detect if the rotation function is available - if it is not available the rotation buttons are hidden. |
| $show_big_left_right_buttons | (true/false) shows the left - right buttons in the HTML navigation. In the DTHML navigation the buttons are always hidden! |
| $enable_counter | (true/false) New 1.2 - enable/disable the counter in the left lower corner |
| $show_counter | (true/false) New 1.2 - show the counter - if not shown the counter is still counting! |
| $show_today_counter | (true/false) New 1.2 - show the counter of today or only the overall counter |
| $enable_counter_details | (true/false) New 1.2 - enable/disable the detail popup when you move over the user counter |
| $enable_counter_details_by_mouseover | (true/false) New 1.2 - If true the counter history does popup by moving over the counter, If false is by clicking on the counter! |
| $show_help_link | (true/false) New 1.2 - Shows the help link |
| $show_first_last_buttons | (true/false) New 1.2 - Shows/hides the first and last buttons on the details page in the upper navigation. |
| $enable_dir_description_on_image | (true/false) New 1.2 - shows/hides a directory description (folder.txt) on the image page if existing. |
| $show_translator | (true/false) New 1.2 - shows/hiddes the name of the translator if he/she was specified in the language file. |
| $show_image_rating | (true/false) New 1.3 - Enables the rating of images |
| $show_rating_security_image | (true/false) New 1.3 - enables an additional page where you have to enter a 4 digit security number that is shown on an image - used to prevent robots to vote! |
| $image_rating_position | (String) New 1.3 - Position of voting. Valid entries: menu, over_image, below_navigation |
| $enable_download_as_zip | (true/false) New 1.3 - you can enable that whole dirs can be downloaded if a zip is provided - see the how-to |
| $show_enhanced_file_infos | (true/false) New 1.3 - Shows the 'Info' of an image in the menu |
| $show_download_counter | (true/false) New 1.3 - Shows the download counter in the info box. |
| $show_exif_info | (true/false) New 1.3 - Shows the 'Exif Info' of an image in the iframe |
| $show_topx | (true/false) New 1.3 - Before show_count_views was used but now we have much more view! - be sure to enable at least one of the topx things (views, downloads, rating, comments!) |
| $show_topx_comments_details | (true/false) New 1.3 - shows the latest comment next to the image - false - view like the other one ! |
| $topx_default | (String) New 1.3 - 'views','comments','dl','votes','average' |
| $show_search | (true/false) New 1.3 - shows the search |
| $preselect_caption_search | (true/false) New 1.3 - Preselect the caption checkbox in the search window |
| $preselect_comments_search | (true/false) New 1.3 - Preselect the comments checkbox in the search window |
| $preselect_filenames_search | (true/false) New 1.3 - = fullscreen modus -- This modus is intended for people who want to show their images like in a slideshow but with manual navigation. The images are not cached in this modus because they can get very big! |
| $preselect_folders_search | (true/false) New 1.5 - Preselect the folders checkbox in the search window |
| $preselect_last_search | (true/false) New 1.5 - Preselect the last upload checkbox in the search window - It should be false by default because the search does not combine good with the other ones |
| $autojump_if_one_result | (true/false) New 1.5 - If true the search jumps directly to he result if only one hit was found. |
| $show_topx_search_details | (true/false) New 1.3 - If you want a more detailed view for the search set this parameter to true - If you want more thumbnails and less text use false here! |
| $image_txt_position | (String) New 1.4 - top,bottom,side - if you use side you have to provide an image.txt AND an image2.txt - image.txt is used for the left, image2.txt for the right side nex to the image! - image.txt does a include of the whole text that is in the file - you can even use php in there! At all other .txt files only the first line is read! - check the how-to for more details |
| $show_public_admin_link | (true/false) New 1.4 - enables disables the link to the admin area ! |
| $skip_thumbnail_page | (true/false) skip thumbnail page - if you set this to true, the thumbnail page is not displayed - be careful if you have subdirectories some levels cannot be displayed if a level before has pictures as well (like the demo). |
| $auto_skip_thumbnail_page | (true/false) New 1.5 - If you set this to true the thumbnail page is only shown if you have more then numberpics (=images in the thumbsstrip in the directory). Why show an overview if all images are shown on the next page anyway ;) - false shows the thumbspage everytime. If the big navigation is not shown the thumbspage is shown always. |
Lightbox
This is a small section that is the bonus for registered users! You can configure the lightbox feature you can see in demo 1.
| $activate_lightbox_thumb | (true/false) New 1.4.2 - activates this feature on the thumbnail page. |
| $activate_lightbox_thumb_full | (true/false) New 1.4.2 - if true the whole thumbnail activates the lighbox script. It's then not possible to get on the image page anymore. If false, there is a small zoom icon in the left upper corner of each thumbnail. If you click on this the lighbox image is shown. |
| $use_original_on_thumbspage | (true/false) New 1.4.2 - if true the whole thumbnail activates the lighbox script. It's then not possible to get on the image page anymore. If false, there is a small zoom icon in the left upper corner of each thumbnail. If you click on this the lighbox image is shown. |
| $activate_lightbox_topx | (true/false) New 1.4.2 - activates this feature on the TopX page. |
| $activate_lightbox_topx_full | (true/false) New 1.4.2 - if true the whole thumbnail activates the lighbox script. It's then not possible to get on the detail page anymore. If false, there is a small zoom icon in the left upper corner of each thumbnail. If you click on this the lighbox image is shown. |
| $use_original_on_topxpage | (true/false) New 1.5 - normally the detail image is used on the topx for the lightbox - but you can use the original too if you like! Just set the parameter to true! |
| $activate_lightbox_image | New 1.4.2 - if true clicking on the detail images does not open the image in a new window or a popup but in the lightbox. Download has to be activated to use this feature + you cannot download the lighbox image with 'right click -> save image'. |
Additional features
In this section you can customize internal features of TWG
| $sort_images_ascending | (true/false) true: Sorts the images ascending; false: descending. This setting if for dates and filenames! |
| $sort_by_date | (true/false) Sorts the images by file name if set to false - if set to true it tries to read the image exif data - if this fails it uses the filetime to sort! - read the faq for the settings you need on your server to get exif data! If you have a lot of images in a directory setting this parameter to true could slow down the gallery because the data is read every time a directory is read. |
| $sort_by_filedate | (true/false) New 1.2 - uses the last modified file date and is not searching for exif data. If false is looks for exif data and uses the file time only if no exif data is available. |
| $sort_albums | (true/false) New 1.2 - sometimes sorting is not wanted - I cannot tell how the sorting will be - but maybe exactly how you like it (most of the time it is the order the directories are created!) |
| $sort_albums_ascending | (true/false) true: sorts the albums ascending; false: descending. |
| $sort_album_by_date | (true/false) New 1.3 - enables sorting of folders by last modified date |
| $autodetect_filenames_as_captions | (true/false) If true the filename is taken as caption if the filename contains less then 4 numbers (e.g. Hello. jpg is o.k, CIM12345.job is not). If false - filenames are not used; |
| $autodetect_filenames_as_captions_number | (true/false) New 1.2 - if you set $autodetect_filenames_as_captions = true you can set the number of numbers that are allowed in a filename that it is used as caption. e.g. setting this to 3 means 3 numbers are allowed in a filename to be used as a default caption - if a file name has 4 numbers it is not used as default |
| $center_cmotiongal_over_image | (true/false) New 1.2 - enables/disables to center the cmotiongallery when you move the mouse over the big image |
Watermark
This section is responsible for all the watermark stuff
| $print_text | (true/false) You can print some text on the lower left corner to protect your images or at least make it a little bit harder to copy it without doing anything :). If you change this setting please delete the cache folder - otherwise generated images are not changed. This function needs the FreeType library installed! |
| $print_text_original | (true/false) Prints the text or a watermark (see below) on the download image! - $enable_direct_download has to be set to false. |
| $font | (String) The font can be stored in the TWG main directory! |
| $fontsize | (Number) The font size |
| $fontsize_original | (Number) New 1.2 - Font size of the watermark on the original image |
| $text | (String) The text |
| $textcolor_R $textcolor_G $textcolor_B |
(Number) The RGB value of the color as decimal |
| $print_watermark | (String) You can make a watermark on the images to protect your images or at least make it a little bit harder to copy it without doing anything :) If you change this setting please delete the cache folder - otherwise generated images are not changed. Please read the description of the parameters that belong to the watermark to get best results! |
| $print_watermark_original | (true/false) New 1.2 - does print the watermark on the original as well - $enable_direct_download has to be set to false!!! |
| $watermark_small | (String) This is the watermark that is used on the detail and slideshow images - can be jpg or png - png gives better results. |
| $watermark_big | (String) This is the watermark that is used on the download images - can be jpg or png - png gives better results. You can use a larger image here because the original images are most of the times much bigger |
| $position | (Number) You can define the location of the watermark with this setting. The numbers show the position of the image: 1 2 3 4 5 6 7 8 9 |
| $transparency | (Number) You can also set the transparency of your logo. 0 is no transparency - 100 max; Try your logo with different settings to get best results |
| $t_x $t_y |
(Number) The next two settings define the position of a transparent color in your watermark. If your logo has e.g. a white border you can set the values to 0:0 and the border will be transparent. If you don't want a transparent color set this values to -1! |
In this section you can customize/setup the emails features of TWG .
| $enable_email_sending | (true/false) New 1.2 - You can enable/disable the sending of emails - The user can still register but no notification emails are sent. The admin side can still be used but no e-mail are sent - set this to false if you are testing twg and you don't want to send any emails! |
$show_email_notification |
(true/false) New 1.2 - enable/disables the end-user and the admin part if logged in :). The emails are stored in the counter/subscribers.xml (plain text file!) |
| $encrypt_emails | (true/false) New 1.2 - enable/disable encryption of emails! - if you change this your subscriber.xml file will become invalid! - you are not able to fix this file manually if you turn the encryption to true. if you set this to false make sure that the file can not be read from outside - set the xml directory to 770! |
| $encrypt_emails_key | (String) New 1.2 - this key is used to encrypt and decrypt the emails in the subscriber.xml - the longer the saver! - (please use 1-9, a-z or A-Z to make the algorithm work properly! - no e.g. ÄÖÜ are allowed!) - internal the key is permutated 2 times and added to this string to add additional security ;). If you cange this string all existing emails cannot be used anymore! |
| $youremail | (String) New 1.2 - this e-mail, will be the reply-to mail for the registration !! |
| $default_subject | (String) New 1.2 - This is the default subject for the emails which can be send to the registered users. |
| $default_text | (String) New 1.2 - The default e-mail body. twg_root is a internal variable to the main page of the gallery - If you want a different link please change it. |
| $email_bottomtext | (String) New 1.2 - Every e-mail gets this footer. It makes it easier for your users to get back to your gallery. twg_root is an internal variable to the main page of the gallery - If you want a different link please change it. |
| $admin_email | (String) New 1.3 - E-mail address where the notifications are sent to. |
| $send_notification_if_comment | (true/false) New 1.3 - if true a notification is sent every time a user enters a comment. |
| $notification_comment_subject | (String) New 1.3 - Subject of the comment notification e-mail. |
| $notification_comment_text | (String) New 1.3 - Text for the comment notification e-mail. %s is the link to the image the comment was entered. |
| $send_notification_if_rating | (true/false) New 1.3 - if true a notification is sent every time a user enters a rating. |
| $notification_rating_subject | (String) New 1.3 - Subject of the rating notification e-mail |
| $notification_rating_text | (String) New 1.3 - Text for the rating notification e-mail. %s is the link to the image the rating was entered. |
Bandwidth settings
In this section you can set the low bandwidth parameters
| $test_client_connection | (true/false) new 1.2 - you can enable/disable the connection test of TWG. It is now integrated into the main page (in <v1.2 it was an extra page!) - there the parameter lowbandwidth or highbandwidth are set! Optimizer settings $low_ ... this settings are used if the parameter &lowbandwidth=true was provided once &highbandwith=true uses the original settings. These settings are for users that have maybe only ISDN or a 56k modem. The file speed.htm does measure the speed of a connection and calls the index.php with the parameter lowbandwidth or highbandwidth - if you want to provide the same settings for all - just call the index.php directly :) - if you set this to false the bandwidth icon is not shown! |
| $test_connection_background | (true/false) New 1.4 - normally the speedtest is done before the 1st page is loaded to optimize it - but is does not look nice but all low settings are done properly - if you use the inline test the view of your gallery can change when the user clicks something because e.g. show_colage has a different value in low bandwidth mode ! - it's up too you ;). |
| $bandwidth_limit | (Number) This is the minimum value (64 kbit ~ ISDN) a user have to have. If this speed is not reached the low_ parameters are used if test_bandwidth=true; With the actual setting you have to have more then normal ISDN to get the high bandwidth settings! |
| $low_show_colage $low_count_views $low_cmotion_gallery_limit_ie $low_cmotion_gallery_limit_firefox $low_compression $low_thumbnails_x $low_thumbnails_y $low_number_top10 $low_show_big_left_right_buttons $low_twg_slide_type $low_enable_maximized_view $low_default_is_fullscreen |
(true/false) The description of the parameter are the ones without the low_ |
| $low_show_big_navigation $low_twg_slide_type |
(String) The next two settings are normally set by an url parameter - in the low bandwidth mode these url parameters are overwritten at the 1st call - but can be overwritten again by the user in the next call. (bandwidth test is only done once!) |
| $low_default_big_navigation | (String) Normally not shown in lowbandwidth modus - but the user can still enable the big navigation - and than this is the default |
| $low_show_background_images |
|
| $low_folder_effect | (String) New 1.4 - you can select a different folder effect for low bandwidth or disable it! |
| $low_activate_lightbox_thumb | (true/false) New 1.5 low settings for the lightbox script |
| $low_activate_lightbox_thumb_full | |
| $low_activate_lightbox_image | |
| $low_video_autostart | |
| $low_show_videos |
Tips
You can show the user some tips or help or additional info if you like at the bottom -
Just enter them in the language file $lang_tips_overview, $lang_tips_thumb, $lang_tips_image as array
The style is defined in style.css: .twg_user_help_td
| $show_tips_overview | (true/false) New 1.2 - enables to show a small tip on the overview page. You can enter own hints in the language file at lang_tips_overview. |
| $show_tips_overview_once | (true/false) New 1.2 - true: shows a tip only once per session |
| $show_tips_thumb | (true/false) New 1.2 - enables to show a small tip on the thumbnail page. You can enter own hints in the language file at lang_tips_thumb. |
| $show_tips_thumb_once | (true/false) New 1.2 - true: shows a tip only once per session |
| $show_tips_image | (true/false) New 1.2 - enables to show a small tip on the image page. You can enter own hints in the language file at lang_tips_image. |
| $show_tips_image_once | (true/false) New 1.2 - true: shows a tip only once per session |
Internal settings
In this section you can set some internal settings which you should only change if you know what you do ;).
| $debug_file | (String) This is the name and location of your debug file - if any error happen at TWG - they are written there! Some installations don't allow to write this file to the main directory! please write this file to the cache directory then. |
| $cache_time | (Number) Number of days until big images (big and slideshow images) files hat are not touched will be deleted from the cache. If you don't want cache cleanup use -1 here. Some OS return at this test instead the last time where the file was touched the time when it was last modified. The generated big images are deleted a little bit faster than ;). Thumbnails are never deleted! |
$cmotion_gallery_limit_ie |
(Number) This is the max number of images that are show in one cmotion gallery. At the end there will be a small arrow to go o the next x images :). IE does nice backgroundloading and therefore the number of images can be much larger (after loading 5 images the cmotiongallery can be used!) Firefox don't have access to switch images after loading with this script (if someone can solve this - die developer of the script couldn’t :() and all images have to be loaded in the beginning (20x4k=80k - with ISDN ~ 10 sek - thats the maximum I would wait!) |
| $enable_optimize_cmotion_gallery_limit_ie | (true/false) Enable IE optimization for the cmotion gallery - if sometimes the preview images below the big images do not appear - set this value to false - cmotion_gallery_limit_ff is used then for all browsers! |
| $extension_slideshow | (String) Extension for slideshow images (stored in the $cachedir). |
| $extension_thumb | (String) Extension for thumbnail images (stored in the $cachedir). |
| $extension_small | (String) Extension for the web images (stored in the $cachedir). |
| $double_encode_urls | (true/false) New 1.2 - some servers need double encoding of all urls to work correctly - normally this is not needed but if TWG fails with spaces in filenames ... try a true here ! |
| $test_email_by_checking_url | (true/false) New 1.2 - twg can test entered emails by trying the corresponding e-mail domain - e.g. test@test.com would be tested by opening a connection to www.test.com - if this fails the e-mail is not valid. This is not a 100% test because there are a few e-mail servers that don't have a Http server running! If you set this to true these users have to enter a different e-mail - if you are not online (test against wwww.google.de fails!) this test is skipped. |
| $password_file | (String) New 1.2 - You can set the password file here. On a Unix system you can use e.g. '.htprivate' to secure the private file! |
| $enable_folderdescription | (true/false) New 1.2 - if you don't use this (folder.txt) turn it off - make the gallery a little bit faster :) |
| $enable_foldername | (true/false) New 1.2 - if you don't use this (foldername.txt) turn it off - make the gallery a little bit faster :) |
| $enable_external_html_include | (true/false) New 1.2 - Enables disables usage of: header/footer/overview/thumb and image.htm ! - if you don't use this turn it off - makes the gallery a little bit faster :) - see how-tows if you don't know what you can do with these htmls! :) |
| $enable_smily_support | (true/false) New 1.2 - :) , ;) and :( are shown as smilies - adapt the size of the smilies if you change the font size ! - read the how-to about smilies !! |
| $twg_version | (String) New 1.2 - version for the administration and the display :) |
| $url_file | (String) New 1.3 - you can place your images on an extern http - on the local server are only some working images! This only works of fsocksopen is available. Please check the how-to! |
| $cache_dirs | (true/false) New 1.3 - content of directories are cached in the session - you can disable this if you have lots of image updates or are testing TWG while uploading. |
| $show_background_images | (true/false) New 1.3 - you can enable/disable the including of the background images - turn this of if you don't use the background image back.png |
| $min | (Number) New 1.3c - after how many minutes does a user count as a new user - 2 means that if he does not do anything for 2 minutes the counter is increased. |
| $resize_folder_gif | (true/false) New 1.3c - if you exchange the original buttons/ordner.gif and the gif is too big it is not resized by default and this looks bad in ie or ff - set this swtich to true - the gif is resized to the menu size of the others! this works too for the folder.gif and the private.gif! |
| $use_sha1_for_password | (true/false) New 1.2 - you can use SHA1 or SHA256 to generate the hash values of the passwords. true = SHA1, false=SHA256. If SHA1 is not available on your system (php <4.3) the internal SHA256 is used! TWG has a password.php where you can generate your passwords! |
| $try_to_increase_memory_limit_to_32MB | (true/false) New 1.4 - TWG can try to increase the memory limit to 32MB - but this is most of the time disabled by security reasons - if you have problems with the memory you can try to set this to true. if you find errors in the debug file because of this - use false here ... |
| $image_file_extension | (String) New 1.4 - image.txt can be renamed to image.php - this can be useful because you can include php code in this file then and you can implement some logic to display some individual information for each file (in HTML and HTML_SIDE mode only - DHTML mode does not reload the page) - you can get the image name with the variable $image |
| $exclude_directories | (String) New 1.4 - You can enter directories here that are ignored in TWG |
| $disable_direct_thumbs_access | (true/false) New 1.4.1 - if you use private folders and really want to protect your images 100% you have to set this switch to true! then ALL images are loaded over the image.php and no thumbs are directly linked anymore - it is then possible to protect your cache as well. The optimized slideshow is then disabled because it does only work with the cache! |
| $show_subdirs_first | (true/false) New 1.4.1 - if you have folders and pictures in one folder - this is the switch where you can decide which to show first! if you show folders first less thumbnails are shown! If pictures are shown first this is not the case because the row detection does not work the other way around. |
| $disable_enhanced_keybord_navigation | (true/false) New 1.4.1 - If you include TWG into a page and you have other input fields you should disable the enhanced keyborad navigation for t=title, c = comments ... |
| $show_powered_by_twg_as_text | (true/false) New 1.4.1 - you can change the TWG logo to a text - if you want to remove it you have to register! |
| $show_twg_logo_if_registered | (true/false) New 1.5 - You can register and still show the TWG image if you like to support TWG |
| $enable_random_image_caching | (true/false) New 1.4.2 - You can enable caching of random images - if you have enough space and the thumbsize is not the random size you can urn his to true - shows he random images much faster if they are already generated. |
| $timezone | (String) New 1.4.3 - for all date calls a timezone has o be set since 5.1.x - if you need exact times - enter your timezone - see http://www.dynamicwebpages.de/php/timezones.php |
| $store_xml_in_picfolders | (true/false) New 1.5 - you can now store your xml files in the pictures folder - please read the howto to use this feature! |
Configuration with an url parameter
Configuration by url parameter - They have only to be added to one request only!
- &twg_noborder=true - Adding this parameter to the url disables the border. This is very good If you want to integrate the gallery into a frame or iframe - See the 'include_example.htm' in the main directory for an easy example.
- &twg_withborder=true - Adding this parameter to the url enables the border.
- &twg_smallnav=true - Adding this parameter to the url disables the big navigation on the details page (could be useful if you want to integrate into an existing homepage to save some space!).
- &twg_bignav=true - Adding this parameter to the url enables the big navigation on the details page.
- &twg_lowbandwidth=true - Adding this parameter to the url optimizes the gallery for slow connections. The $low_... parameters are used.
- &twg_highbandwidth=true - Adding this parameter to the url resets the lowbandwidth mode. The normal parameters are used.
- &twg_dhtml_nav=true - Adding this parameter to the url enables the big dhtml navigaion (twg_bignav has to be true).
- &twg_html_nav=true - Adding this parameter to the url enables the big html navigaion (twg_bignav has to be true).
- &twg_slideshow_time=<time> - Defines the default slideshow interval. The default is set in the config.php
- &twg_slide_type=<value> Defines the default slideshow type - TRUE is the crossfade version, FALSE the normal version, FULL the maximized version! The default is set in the config.php.
