In most cases, you will not need to modify ini file settings. This section is presented for advanced users only.
Many configuration settings are available through your Listings Manager's Setup
Options, however, less commonly used settings are reserved for the exec/config.ini
file and must be edited with a text editor. Be very careful to keep a backup of
this file. If this file is corrupted, you will receive an error message when running
Listings Manager. You will not be able to login or use the program until
the file has been repaired.
General Settings
| option | description |
| umask |
umask = 000 Some web servers are configured so that files created by scripts have restricted permissions. This can cause a problem for Listings Manager because it requires its own data files to be writable by the program itself. If you find that you can create a listing once, but not on subsequent attempts, take a look at the data/* files to see if they still have 777 permission. If not, you can set this config option to "000" to explicitly tell the program what umask permissions to use. |
| publish_all_heartbeat |
publish_all_heartbeat = 50 When you do a Publish All from the Setup Options, it can take a long time to complete if you have many listing. Depending on the configuration of your web server, this operation can result in a server timeout error because the web server did not receive any results from the program during this lengthy operation. To compensate for this, you can set this config value to 50. This tell the program to send "heartbeat" output (HTML comments) to the web server every 50 records to let the server know the program is still alive and running. This option was added in version 2.29. |
| publish_index_heartbeat |
publish_index_heartbeat = 200 This value is similar to the publish_all_heartbeat value, except that it is used when updating the homepage and listing indexes. This operation occurs when you add or modify a listing, or when you select Publish Index from the Setup Options. Writing the index is less resource-intensive than a Publish All, so this config value can be set to a higher value than publish_all_heartbeat (e.g. 200 means send a heartbeat every 200 records when publishing an index). This option was added in version 2.29. |
| disable_filelocking |
disable_filelocking = 1 Filelocking prevents two programs from updating the same data files at the same time. Turning off filelocking can make you more vulnerable to data corruption. Be sure to backup your data files often if you need to disable filelocking. This option was added in version 2.30. |
| max_filelock_wait |
max_filelock_wait = 5 This is the number of seconds the program will wait for a filelock to become available. If it has to wait longer than this amount of time, the program returns a filelock warning message. You can increase the time to wait by adjusting this setting. This option was added in version 2.30. |
Thumbnail Settings
| option | description |
| disable_thumbnails |
disable_thumbnails = 1 This setting disables all thumbnail generation, including the "recreate all thumbnails" button. Thumbnail generation requires the proper installation of the Image::Magick or GD third-party Perl modules. On some systems, an improper installation or version of a module can prevent the program from running. If that is the case with your system, set this value to 1 to turn off thumbnailing completely. This option was added in version 2.29. |
| allow_larger_thumbnails |
allow_larger_thumbnails = 1 This option allows a thumbnail's file size to be larger than the original image's filesize. In most cases, a thumbnail's file size will be smaller than the original image's file size. However, in certain situations a thumbnail can become bigger. For example, you have an original file that is a compressed GIF file which is close in size to the thumbnail size, and your Perl image module only creates uncompressed GIF files. By default, the program will simply copy the original file as the thumbnail if the thumbnail is going to be bigger. Setting this option to 1 will allow these larger sized thumbnails to be created. The advantage of setting this option is that the thumbnail will have the smaller pixel dimensions. This option was added in version 2.29. |
| skip_imagemagick |
skip_imagemagick = 1 This value will disable the detection of ImageMagick perl modules. This may be necessary if your server's installation of ImageMagick does not include the common commands used by the thumbnailing functions. Ordinarily ImageMagick is given preference over GD - disabling ImageMagick detection will make GD available, if installed. This option was added in version 2.29. |
| skip_gd |
skip_gd = 1 This value will disable the detection of GD perl modules. This may be necessary if your server's installation of GD does not include the common commands used by the thumbnailing functions. This option was added in version 2.29. |
| thumbnail_heartbeat |
thumbnail_heartbeat = 20 When you do a Recreate All Thumbnails from the Setup Options, it can take a long time to complete if you have many images. Depending on the configuration of your web server, this operation can result in a server timeout error because the web server did not receive any results from the program during this lengthy operation. To compensate for this, you can set this config value to 20. This tell the program to send "heartbeat" output (HTML comments) to the web server every 20 images to let the server know the program is still alive and running. This option was added in version 2.30. |