Many configuration settings are available through Article Manager's Setup Options, however, less commonly used settings are reserved for the 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 Article Manager. You will not be able to login or use the program at all until the ini file has been fixed.

General Settings

option	description
datadir	This is where Article Manager looks for all its data files.
filelocking	Filelocking prevents two programs from updating the same data files at the same time. Turning off filelocking can cause data corruption. Be sure to backup your data files often if you need to disable this feature.
filelock	This is the name of the directory that is created as a filelock.
allow_mod_perl	Article Manager has not been specifically designed for mod_perl. See your web server's documentation for information on how to disable mod_perl. Article Manager will display an error message and will refuse to run under mod_perl. Although we do not recommend doing so, you can turn off this warning by enabling this ini setting.
login_timeout	This is the amount of time in seconds before Article Manager will log out a user due to inactivity.
allow_ssi	Prior to Article Manager 1.24, this option is used to allow/disallow SSI input to the program. In Article Manager 1.24 and later, use the xssfilter.ini file to control SSI's.
demo	By enabling Demo Mode, you can prevent any potentially dangerous changes from being made with the program. A lot of functionality will be lost, for example, administrators will be able to see the Setup Options, but will not be able to modify them.
hide_upgrade	When this value is set to 1, the "Upgrade" section at the bottom of the General Setup Options will not be displayed. Please note that this option is only available in Article Manager 1.2 and later.
enable_xss_filter	Enabling the XSS filter will cause the content entered by users to be filtered for harmful HTML. To explicitly disable this feature, set this option to 0. To explicitly enable this feature, set this option to 1. Refer to the documentation on the xssfilter.ini file for more information.
article filename checking	allow_duplicate_article_filenames = 0 This flag determines whether duplicate article filenames are allowed. By default, this is set to zero, forcing the verification of article filenames against each other and against category filenames and global files. With a value of 1, duplicates are allowed. Unless the articles are being published to a custom subfolder (see Category Options), articles can overwrite each other or other files with no warning.
umask settings	umask = 000 Some web servers are configured so that files created by scripts have restricted permissions. This can cause a problem for Article Manager because it requires its own data files to be writable by the program itself. If you find that you can create a article 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.

[categories] Settings

option	description
max_breadcrumb_option_length	The maximum text string length of breadcrumbs when displayed in the administrative program. Breadcrumbs will be truncated when exceeding this character limit.
option_indentation_string	The amount of padding preceding each subcategory when output in a category list in the administrative program.
option_indentation_suffix	The character (or text) displayed between the subcategory indentation and the subcategory's name when output in a category list in the administrative program.

[article_editor] Settings

option	description
summary_cols	The width of the Summary field textarea on the article edit page.
summary_rows	The height of the Summary field textarea on the article edit page.
content_cols	The width of the Content field textarea on the article edit page.
content_rows	The height of the Content field textarea on the article edit page.
image_alignment	The default alignment for ***image1*** placeholders.
earliest_year	The earliest year available from the dropdown on the Article Editor screen. This setting may not be set any earlier than 1980. This feature was added in version 1.04.
latest_year	The latest year available from the dropdown on the Article Editor screen. This setting may not be set any later than 2032. This feature was added in version 1.04.

[language] Settings

option	description
month_abbr	Month abbreviations in a comma separated list.
month_full	Full month names in a comma separated list.
week_abbr	Weekday abbreviations in a comma separated list.
week_full	Full weekday names in a comma separated list.
ampm	How to display AM and PM, separated by a comma.
ordinals	A list of numbers to display in dates. This list is comma separated, beginning with zero (0).
acl_names	A comma separated list of access level names.

[ui] Settings

option	description
perpage	The default number of records to display on a list page within the control panel.
bgcolor	Specify the color of the background behind Article Manager.
date_format	Describes the format for displaying a date. (See below)
time_format	Describes the format for displaying a time. (See below)
datetime_format	Describes the format for displaying date and time together. (See below)

[search] Settings

option	description
ignore_word_boundaries	By default, the program's search engine will search for keywords which match the beginning of a word. Since "word characters" are assumed to be English word characters, this method of searching may not work for some sites. If you set ignore_word_boundaries = 1, the search engine will match search keywords anywhere within a document (e.g. "ping" will match "shopping").

[publish] Settings

option

description

allow_images_in_webfeed

By default, image placeholders are removed from syndicated content for bandwidth reasons. If you would like to keep images in your webfeeds, you'll need to enable this flag. Although our newer syndicate.js file has the appropriate templatecells, if you're using an old version of syndicate.js you'll want to either upgrade it or add templatecells for both images with captions and images without captions. You can simply copy these templatecells from the default article template.

[server_side_parsing] Settings

option	description
do_not_erase_temp_files	Article Manager creates temporary files when generating search.cgi and view.cgi results. Enabling this key and setting the value to "1" will prevent the auto-removal of these temporary files. Any temporary files will need to be deleted manually. This should always be disabled (set to zero or commented out) unless you need to see the generated HTML pages to debug your templates.

[email] Settings

option	description
event_names	The default values for the $event$ placeholder in <install_dir>/templates/email/notify.txt are created and modified.  You may change either or both of these values to better suit the email you wish to send.
status_names	The default values for $status$ in <install_dir>/templates/email/notify.txt are pending, visible, hidden, and erased.  You may change any or all of these flags, affecting only the notification email but not the options in the add/modify article admin screen.
notifications_to_field	This field is blank by default. Example: "Article Manager Users" <admin_email@yoursite.com>. The address you put in this section receives all notification emails in addition to any user accounts configured to receive them.
bcc_list_separator	This configures the character used to separate email addresses in the notification BCC list. If missing, this value will default to semicolon (;).

[SMTP] Settings

option	description
smtp_helo	If your SMTP server requires a "helo domain" other than "localhost" (the default) use this option to change the value.
smtp_timeout	The default timeout is 30 seconds for communicating with your SMPT server.  You may change it here.

Date/Time Formats

A date/time format is a string of text with special markers. Markers begin with a percent sign and are followed by one character. By using a combination of these markers in your string, you can describe how dates and times are displayed. See %c for an example.