Oscailt Main Configuration Page

Where it is

• Go to Main Admin Page => Click on Edit Configuration or
• enter http://yoursite.name/*editconfiguration.php* into your browser address box

What you can do on this page

The main configuration page allows you to change settings which affect the entire installation of oscailt. For example, it allows you to specify which directories will be used to store oscailt's data in. It allows you to decide what types of logs you want to collect as well as specifying limits on uploaded file sizes and various other limits. The settings on this page are roughly divided up into three groups.

Although several of the settings on this page are also settable in the configuration of individual modules, they are included in this page to ensure that no badly-configured module can threaten the integrity of the rest of the system. For example, you can set the maximum size of attachments here which prevents any administrators creating publish pages which allow larger attachments. If you have several site-sections with autonomous adminstrations, this can be very useful.

Other security settings provided here allow you to specify where you will accept html and bbcode from ordinary users of the site. Although these settings relate only to the publish module (and therefore logically belongs in the publish module configuration page) it must be specified as a system wide setting since it has potential serious security implications and thus we must prevent the creators of individual publish objects from altering this setting to a less secure setting than that decided by the overall administration.

The following settings are available:

Site Identification Section

The basic data used to identify your site. This is used in RSS news syndication and throughout the site to generate links and references to this site as well as to create the page titles.

Short Name The name of your site Long Name A longer name of your site Use Friendly URL's Do you want the site to use search engine friendly URLs for each page. For example this means that you can use urls like article/23432 instead of ?obj_id=234&story_id=23432 Description Details of your site - is used in the page description meta tag indexed by search engines Keywords Comma separated keywords of the site. Also indexed by search engines URL The url with no http:// or trailing /

Oscailt Internal Data Storage Settings

The directories that attachments, style-sheets and cached images are stored in. Ensure that these directories are writable by the user the apache process is running under and is accessible from the web-server root. Attachment Store File System Path The absolute path of the attachment store from the system root (must have trailing slash) URL Path The path of the attachment store relative to the web root (must have trailing slash) Image Cache File System Path The path of the image cache relative to the web root (must have trailing slash) Site File Store File System Path The path to the site file-storage directory relative to the web root (must have trailing slash) Private File Storage for caches and data object storage The directories that oscailt will use to store private internal data in. Ensure that these directories are writable by the user the apache process is running under, but they should not be publically accessible. Private Cache Directory File System Path The path of the cache store relative to the web root (must have trailing slash) Object Index Storage Either enter sql if you want to store data object indices in the database or enter the path of the object index file relative to the web root. Data Objects Storage Location Either enter sql if you want to store data objects in the database, or enter the path of the object storage directory relative to the web root (must have trailing slash) Exported Objects File System Path The path to the directory where exported objects will be saved. This can be visible from your web-server if you want to publically share your data object configurations.(must have trailing slash) Maximum Attachment Sizes The max size of file uploads (may not apply to editors depending on permissions), Values may not exceed max file size set in php.ini. Values may be set to lower values for individual sites, but these limits are are the maximum allowed for all the sites configured as part of this oscailt installation Image Files Kilobytes Image Files (width) Pixels Video Files Megabytes Audio Files Megabytes Miscellaneous Files Megabytes Story Attachments These restrictions may not apply to editors Allow Image Files

Allow Video Files

Allow Audio Files

Allow Miscellaneous Files

Max Attachments Per Story This Maximum number of attachments that a user may attach to a story Files Editor Max Attachments This only applies to intial publication, editors may add more files when editing stories Files Comment Attachments These restrictions do not apply to editors Allow Image Files

Allow Video Files

Allow Audio Files

Allow Miscellaneous Files

Max Attachments Per Comment This only applies to intial publication, editors may add more files Files Content Length Restrictions Maximum Limits for content fields. Max User Comment Length Kilobytes Max User Story Summary Length Kilobytes Max User Story Contents Length Kilobytes Editor Max Comment Length Kilobytes Editor Max Story Summary Length Kilobytes Editor Max Story Contents Length Kilobytes Email Settings Settings relating mainly to the automatic mails sent when editors modify content on the website. These settings may be over-written for individual site sections in the installation. Notification From Address The address from which all mail generated by this site will be sent. You must ensure that this address is allowed to send from your configured mailserver, and that if sending to a mailing list it is allowed post to it Notification To Address The address to which all automatic email notifications will be sent, usually a list set up for this purpose Notification Reply To Address The address (or addresses separated by comma) which will be added to the replyto section of the auto notifications. Useful if you wish discussion of hidden posts to occur on separate list to the one notifications are sent to Contact Address The address that submissions to the contact form will be sent HTML / Code Input Settings You can choose whether HTML tags will be allowed in publish forms and how it will be processed Allow HTML in story summaries? Should users and editors be allowed to use (limited and defined in markupconfig.inc) HTML in story summaries? Allow HTML in story contents? Should users and editors be allowed to use (limited and defined in markupconfig.inc) HTML in story contents? Allow HTML in comments? Should users and editors be allowed to use (limited and defined in markupconfig.inc) HTML in comments? Support Limited BB code? Should users and editors be allowed to use (limited and defined in markupconfig.inc) BB Code (eg [B]bold text[/B] as well as HTML? Maximum BBcoded text The maximum number of caracters that can be enclosed in BB tags - allows you to stop enormous quotes or all-bold comments. Force Correct HTML Input? Should users and editors be notified of errors in their HTML and forced to fix them before they publish? If you do not check this box, disallowed tags will still be stripped from the content, but the user will not be told of it. Force Correct HTML Input for data objects? Should users and editors be notified of errors in their HTML and forced to fix them before they publish updates to data objects? If you do not check this box, disallowed tags will still be stripped from the content, but the user will not be told of it. Enforce strict HTML Parsing? Should Oscailt forbid unclosed tags, even in cases where it does not affect display (such as p, li, etc) This will help you to ensure that your pages are standards compliant. Data Object Page Settings You can choose which page will be the default front page on your site as well as some other basic choices of page layouts Front Page Object The Data object module that will be the default (index.php) entry point to the site. Administration Page Layout Object The Page Layout setting that the administration page (admin.php) will be view through. Article For Previews In order to properly preview changes to article view settings, you need to specify a valid ID of a story in the database to use in preview mode. Object Caching Settings You can choose to cache objects (strongly recommended to use caching and leave these fields unchecked) as html files to speed up operation Inactivate Object Caching? Use Live Objects instead of cached ones (not recommended)? Automatically Cache Object Updates?. Immediately re-cache updated objects (not recommended). Allow Live Access?. Allow Users To view live objects rather than cached ones? (not recommended). Object Editing Settings You can choose to allow editors to edit objects by clicking on icons beside them in the site menus and banners. Show Icons for Ordinary Objects? Show Icons beside ordinary objects (documents, newswires etc) to allow you to edit them from every page? Show Icons for Container Objects?. Show Icons beside container objects (Menus, Lists, Bars) to allow you to edit them from every page? Show Icons for Page Layout Objects?. Show Icons on page layout objects (Menus, Lists, Bars) to allow you to edit them from every page?. IP Blocks and Bans Block and ban ip addresses and referers from accessing the site. Banned IP addresses Enter IP addresses, one per line. Any users whose address matches these addresses will not be allowed to access the site at all. Banned Referers Enter Referers (sites that link to this site) that you want to block. Blocking nazi sites such as shitefront.org is a good idea. Redirect URL A URL to redirect banned posters to. Whatever you think, gay inter-racial porn or the UNDRM - it's your pick. Logging and Security Settings that govern system security and logging Enable IP monitoring?. Enable Temporary recording of users who publish stories and comments on the site. This allows you to block abusers immediately. IP Monitor Cache Size The number of ip addresses that will be stored. So, if you set this value to 20, oscailt will never store more than the last 20 ip addresses of publishers in the cache Security Logging Level The level of security logging that you want. Set to 0 for no security logging, 1 for logging of malicious attempts to inject scripts into forms and 2 for logging of all tags and bad data. Security IP Recording Do you want to log IP addresses to the security log. Set to 0 for no IP logging, 1 for logging of IP addresses with malicious attempts to inject scripts into forms and 2 for logging of all IP addresses with bad tags and bad data. This will only take effect (obviously) if the above setting includes logging of the events Enable User Error Reporting The level of error reporting about internal errors that you want to be visible to users. Set to 0 for no error messages, 1 for a standard 'try back later message' and 2 for reporting of php and database error messages. Miscellaneous Various Settings that don't fit anywhere else! Enable Newswire Thumbnails Controls whether thumbnails of the first image in a story are shown on the newswire page along with the story summary Default Date Format The Default Date String Format (strftime format eg %A %B %d, %Y %H:%M). Edit Lock Duration The maximum amount of time in minutes that an editor can keep a story locked from other editors while they edit it. Minutes Pre-fill Editor Details You can choose to pre-fill the editor's name and other details into publish forms when editors wish to publish stories. Mono Lingual Filter Controls whether the default view of the site includes all languages or just one. If enabled the default language filter used is the one requested by the clients browser preferences Timezone Offset The offset to shift all times displayed on the site by, to cater for timezones other than the one this site is hosted in. This offset is relative to the host site's local time not GMT. Hours Refresh Rate How often the local cache of syndicated news feeds should be updated Hours

Several of these settings are also included in the configuration of

-- ChekovFeeney - 06 Sep 2005