glFusion Configuration
Almost all of glFusion's configuration options can be controlled via the online
Configuration Manager which is located under the Admins Only menu labeled
Configuration. The Configuration Manager is separated into logical sections.
Site Configuration Section
The Site Configuration section allows you to configure the site URL, name, mail settings, paths and other site related options. Generally, these options should not change often.
Site Tab
Set the site URL, name, slogan, etc. You can also disable the site or put it into maintenance mode from this section.
- Site URL
- Base URL for your site (no trailing slash) - we have updated some info.
- Admin URL
- Base URL of the admin area of your site (no trailing slash). You won't have to change this normally, but some hosting services use a predefined “admin” directory for other purposes. In this case, you can rename glFusion's admin directory and adjust the URL accordingly to avoid conflicts.
- Site Name
- Name of your site
- Slogan
- Slogan for your site. This is added to the HTML title field.
- Site Disabled Message or URL>
- This contains the message to display when a glFusion site is disabled. If the text begins with http: then visitors are redirected to that URL.
- Enable Maintenance Mode
- Setting this to TRUE will block all non-admin users from using the site. All non-admin users will see the Site Disabled Message or URL. Admin users will still be able to access all features of the site. This is useful when you need to perform maintenance on the site and do not want any users to access during the maintenance.
You must login as an admin user before setting this to true!
- Copyright Year
- Set this to the year you want to appear in the copyright notice of your site's footer. If not set, glFusion will use the current year.
- Enable URL Rewrite
- glFusion includes a simple but useful URL rewriting feature which can help make your site more crawler friendly (i.e. the URLs of your site are more likely to be picked up by the search engine's indexing bots). This feature is supported for URLs to stories, static pages, the article directory, and links.
- Facebook App ID
- If you have a Facebook page for your site, enter your Facebook App ID here. This will enable Domain Insights on your Facebook Dashboard. Domain Insights lets you view analytics for traffic to your site from Facebook. Find the app ID in your App Dashboard.
Mail
This is where you configure how your site will send email.
- Site E-Mail
- E-mail address for all admin mail
- No-Reply E-Mail
- This is the sender's address of emails sent by the system when users register etc. This should be either the same as Site E-Mail or a bouncing address to prevent spammers from getting your email address by registering on the site. If this is not the same as Site E-mail, there will be a text in the system messages that replying to this message is not recommended since no one will receive the reply.
- Mail Backend
- Select which email backend to use:
- Mail - Use PHP's internal email
- Sendmail - Call sendmail directly
- SMTP - Send email out via SMTP to external mail server.
If you are not sure which option to select, please contact your hosting provider for assistance.
- Path to Sendmail
- If you chose 'sendmail' for the backend setting, this specifies the complete path to the sendmail executable.
- Sendmail Parameters
- If you chose 'sendmail' for the backend setting, this variable can be used to pass additional parameters to the sendmail program.
- SMTP Host Name
- If you chose 'SMTP' as the mail backend - Place the fully qualified domain name of your SMTP server.
- SMTP Port
- If you chose 'SMTP' for the backend setting, this is the port number to talk to on the SMTP server. The default value is port 25.
- Require SMTP Auth
- If you chose 'smtp' for the backend setting, set this to true if your SMTP server requires authorization, and false if it doesn't.
- SMTP Auth Username
- If you chose 'smtp' for the backend setting, this is the name of your SMTP account.
- SMTP Auth Password
- If you chose 'smtp' for the backend setting, this is the password for your SMTP account.
- SMTP Security Protocol
- If your SMTP server requires a secure connection, select the protocol.
- Force email from address to be site email
- Force the From address to be your site email address. This is useful for hosting providers that do not allow email from addresses that are not from your domain. This will force the Reply-To address to be the email address of the user.
Syndication
glFusion can export its headlines to a news feed in various
formats (RSS,
RDF,
and Atom). This will let you share your news with other sites (Hint:
Create a Portal block from glFusion's Block menu to import news feeds
from other sites).
- Enable Feeds
- Create a feed file for the stories in rdf_file.
- Syndication Output Folder
- File system path for the feed file. This file allows you to share your site's headlines with others.
- Feed Limit
- Limit the number of stories to export to the news feed. If the value for this setting is a number, the feed will hold this many stories. If the number is followed by a lower-case 'h' (e.g. 24h) it denotes the number of hours from which to choose the stories.
- Length of Stories in Feed
- If this value is 1, then the entire introtext of the stories will be included in the news feed. Any number greater than 1 limits the introtext to that many characters (e.g. a value of 80 would only include the first 80 characters from the introtext in the feed). If set to 0, the introtext is not included in the feed.
- Feed Language
- Value for the feed's language tag. Depending on your site's language and operating system, this may differ from the language setting in the locale (see above). Example: The PHP locale setting for German is 'de_DE' while the correct language setting for a German RSS feed would be 'de-DE' (note the dash instead of the underscore).
- Maximum Number of Headers (portal blocks)
- Upper limit for the max. number of headlines when importing a feed (into a portal block). The limit can also be set for each individual portal block in the block menu. When set to 0, all headlines are imported.
Paths
- HTML Path
- Path to your web tree directory for your site (trailing slash necessary). This directory holds all the web pages used by glFusion.
- Log
- File system path for the log files
- Language
- Location of the glFusion language files
- Backup
- Location where glFusion will store database backups
- Data
- File system path for the data directory, used e.g. for the user batch add feature
- Images
- Path where glFusion expects to find its images, including user photos and images for stories.
Search
- Results List Style
- Defines the format of the search results page:
Google Style - Presents the results in a Google Style format
Table Style - Presents the results in a tabular format.
- Page Limits
- Define the valid page options for the Number of items per page dropdown on the search results page.
- Number of Search Results
- Default number of search results per page.
- Show Result Number
- Whether or not to display the number of each search result.
- Show Result Type
- Show the result type (i.e. Forum, Wiki, Story, etc.)
- Show Author
- Show the Author of the search item.
- Show Number of Hits
- Show the number of hits / views of the search item.
- If No Data is Available, Display
- Text to display if there are no search results to display.
- Group Separator
- Separator between groups.
- Default Search Method
- Default Search Method:
- all of the words
- any of the words
- exact phrase
Update Checker
- Update Check Interval
- Specifies how often glFusion should automatically check for updates.
- Send Site Data
- When glFusion checks for updates, if this is enabled, it will also pass the site URL, PHP version and Database version to the glFusion.org site. This data is only used by the glFusion team to gain a better understanding of how many sites are running glFusion. This data is never sold or shared with any other source. If disabled, no information is passed during the upgrade check.
Stories and Trackback
Story
- Max Images per Article
- Maximum number of images you can have in a story.
- Stories per Page
- Number of stories to limit the index page to, this same number will appear in the older stuff block.
- Story List Sort Field
- Field used to sort stories in the Index view. Options are Date (default), Author, Title, StoryID or hits (views).
- Story List Sort Direction
- Sort direction for story list in Index view. Options are Ascending or Descending.
- Enable Infinite Scroll
- If enabled, automatically fetch new stories when the user scrolls to the end of the screen.
- Minimum Stories per Page
- Minimum numbers of stories than can appear on a topic page
- Show “Contributed By”
- Show author username to public, and enable search by username (FALSE=no, TRUE=yes)
- Hide Story Date
- If False, the publish date for the story will appear in the story header. If True, the date will not be displayed.
- Hide Views Count
- Whether to show (FALSE) or to hide (TRUE) the number of views a story has had.
- Hide E-mail Icon
- When set to TRUE, this will disable the ability to send a story by email. It will also hide the email icon from stories and the “Email Article To a Friend” from the Story Options block.
- Hide Print Icon
- When set to TRUE, this will disable display of a story in a “printer friendly” format. It will also hide the printer icon from stories and the “View Printable Version” from the Story Options block.
- Enable Story Rating
- Allow users to rate stories on the site. Valid options are
- Disabled - no rating
- Logged-In User - allow all Logged-in Users to rate stories
- Everyone - Allow any site visitor to rate stories
- Allow Page Breaks
- Allow usage of the [page_break] tag in stories (when set to TRUE), so that stories can spread over multiple pages. THIS FEATURE HAS BEEN DEPRECIATED IN glFusion v1.6.0+
- Topic Icon Alignment
- Which side of article the topic image should be shown (right or left)
- Show Topic Icon
- Default setting for new stories and story submissions: Whether to show the topic icon (TRUE) or not (FALSE).
- Draft Flag Default
- Default setting for new stories created by Story Admins: Whether the story's draft flag should be set (TRUE) or not (FALSE).
- Frontpage Default
- Default setting for new stories and story submissions: Whether the story should appear on the site's frontpage (TRUE) or only in its topic's page (FALSE). Please note that for stories submitted to the archive topic, this setting will be ignored and the story will not appear on the frontpage.
- Hide “No News” Message
- When set to TRUE, hide the “No News To Display” message on the index page (e.g. when viewing a topic without any stories in it)
- Hide Main Page Navigation
- When set to TRUE, this option will hide the “Google paging” navigation from index.php, i.e. from the site's frontpage and all topic pages. This may come in handy for more advanced layouts but will of course prevent people from easily reaching older articles.
- Only Root can Feature
- When set to TRUE, this will only allow members of the Root group to make a story “featured”, i.e. the sticky top story on the site.
- After Saving Story
- Page to land on after saving a story.
Trackback
- Trackback Enabled
- Enable (True) or disable (False) trackback comments. This applies to both sending and receiving trackback comments.
- Trackback Default
- Default value for new stories: Trackback enabled (True) or disabled (False).
- Trackback Speed Limit
- Number of seconds between two trackbacks / pingbacks from the same IP address.
- Check Trackbacks
- This option can be used to check the validity of a trackback. You can check if the URL in the trackback actually contains a link back to your site (otherwise, it's probably spam). You can also check if the trackback was sent from the proper IP address, (i.e. the IP of the site in the trackback URL. Again, if they don't match, it's probably spam). Note that you can add up the values below to do more than one check (but using option 1 and 2 doesn't make sense and will be treated as if you requested option 2). Options are:
* Check against Site URL
* Check against Site URL and full URL
* Check full URL
* Check IP against Site IP
* Check IP and Full URL
* Check IP and Site URL
* Check IP, Full URL and Site URL
* Don't Check Anything
- Multiple Trackbacks
- How to handle multiple trackbacks and pingbacks from the same source. Options are:
* Allow multiple posts
* Only keep latest (overwrite previous entries from this site)
* Reject
Pingback
- Pingback Enabled
- Enable (True) or disable (False) pingback support. This applies to both sending and receiving pingbacks.
- Create Pingback Excerpt
- Unlike Trackbacks, Pingback don't include an excerpt of the text from the site linking to us. When this option is enabled, glFusion will try and create an excerpt by searching the backlink on the site that sent the Pingback, extract a piece of the text near the link, and use that as the excerpt for the Pingback.
- Pingback Self
- Pingbacks are sent out automatically to all the URLs linked from a story - which includes stories on your own site that you may have linked in the article. This option lets you specify how these “self pingbacks” are to be handled: Skip them, (i.e. don't send pingbacks to stories on your own site). Allow them, but obey the speed limit. Allow them and ignore the speed limit.
If your article contains more than one link to other stories on your site, then option 2 is probably of limited use, as it would only pingback the first linked story and run into the speed limit for the others.
- Ping Enabled
- Enable (True) or disable (False) the ability to ping weblog directory services like Technorati.
Theme
Theme
- Theme
- Default theme to use on the site
- Themes Path
- Directory where all themes reside
Advanced Settings
- Always Show Right Blocks
- If set to true, the right-side column of blocks will be displayed on all pages (instead of only on the index page).
- Show First Story as Featured
- When set to TRUE, this will render the first story on any page using the templates for a featured story, even if that story is not featured. This will even be applied to the first story on page 2 of a topic page, for example.
- Compress CSS
- glFusion collects all the site CSS and sends it as a single item. glFusion can perform some simple compression (remove comments, whitespace, etc.) when it sends the CSS. This can speed up the page loads, but it makes the CSS difficult to read if you view the page source.
Caching
- Enable Template Caching
- If this option is enabled (set to TRUE) all templates will be cached, which should improve performance of the web site. In some cases, caching could slow performance down. For example, if the disk access is slow on the web server or if the web server is accessing Windows shared drives, setting this option to FALSE may improve performance.
Blocks
Admin Block
- Sort Links
- If set to true will sort the entries in the Admin's block and the icons on the Submissions page (moderation.php) alphabetically.
- Link to Documentation
- Add a link to glFusion's documentation to the Admin block. Set this to FALSE if you don't want that link to show up.
- Link to Version Checker
- Add a link "glFusion Upgrade Check" to the Admin block so that you can easily check if your glFusion version is up to date. Set this to FALSE if you don't want that link to show up. Note: The link is only displayed to members of the Root group.
Topic Blocks
- Sort Topics
- alpha = Sort topics in topic list alphabetically
sortnum = Sort topics in topic list by sort number
- Show Story Count
- Show the number of stories in a topic in the Sections block (FALSE=no, TRUE=yes)
- Show Submission Count
- Show the number of story submissions for a topic in the Sections block (FALSE=no, TRUE=yes)
- Hide Home Link
- Hide the “Home” link from the Sections block (FALSE=no, TRUE=yes)
Who's Online Block
- Session Threshold
- How long, in seconds, users can be idle before removing them from the whosonline block
- Hide Name from Guests
- If enabled (i.e. set to 1), anonymous users will only see the number of registered users currently online in the Who's Online block but not their names. Only logged-in users will see the names of other users that are currently online.
- Display User Photo Thumbnail
- If enabled (i.e. set to 1), and a photo exists for the user, a thumbnail of that photo will be displayed, otherwise a photo icon will be displayed.
What's New Block
- New Stories Interval
- Stories are “new” if they are this many seconds old.
- New Trackbacks Interval
- Trackback comments are “new” if they are this many seconds old.
- Hide New Stories
- Set to TRUE to hide new stories from the What's New block.
- Hide New Trackbacks
- Set to TRUE to hide new trackback comments from the What's New block.
- Hide New Plugin Entries
- Set to TRUE to hide new entries by plugins from the What's New block.
- Hide What's New Block when empty
- Set to TRUE to hide the What's New block when there are no new items to display.
- Title Trim Length
- Max. length of the title of items listed in the What's New block.
- Time between forced rebuild of the What's New cache in seconds
- The number of seconds that the cache file for What's New will live. For example, if you set this to 3600, this is 60 minutes - which means the What's New block will be rebuilt every hour.
Users and Submissions
User Capabilities
- Allow User Themes
- If set to True, users can set their own theme that the site uses
- Allow User Language
- If set to True, users can select the language for the site navigation
- Allow User Photo
- If set to True, users can upload a photo to their profile
- Allow User name change
- If set to True, users will be allowed to change their username (login name). Stories and comments posted under the old username will automatically show the new username.
- Allow Account Deletion
- If set to True, users will be allowed to delete their accounts. Stories and comments posted under that account will be kept and show up as being posted by “Anonymous”.
- Allow Hide Author
- If set to True, the option to exclude certain authors from being seen is hidden from the user's preferences.
- Show Fullname
- Whether to display a user's full name (= True) or only their username (= False). For users that haven't entered their full name, glFusion will always display the username.
- Show Service Name
- If you allow users to log in with accounts on remote services (like LDAP or LiveJournal), this option will at the service's name to the username to avoid confusion with local users of the same name. Set to false to disable.
- Hide Exclude Content Tab
- When set to true, glFusion will hide the Content tab in the user profile screen. This tab allows users to block certain content and content authors, but it can also cause some confusion with site users.
- After Saving User
- Which page to go to after a user has been saved:
* 'item': display the user's profile
* 'list': show admin's list of users (default)
* 'home': display the site's homepage
* 'admin': go to the “Admin Home” page, i.e. Command & Control
Authentication
- Enable Two Factor Authentication
- Two Factor Authentication, also known as 2FA, is an extra layer of security that is known as "multi factor authentication" that requires not only a password and username but also a six-digit code supplied from your phone or an external app. If enabled, users will have the option to enroll their account into Two Factor Authentication for additional security.
- User Login Method[standard]
- Whether to allow normal logins into the site, i.e. with a user account that only exists in your site's database.
- User Login Method[3rdparty]
- Allow (when set to true) users who already have an account with some other service to log into your glFusion site with the login for that service. Currently supported: LDAP and LiveJournal. Please note that to enable login for a specific service, you need an authorization class in system/classes/authentication. If you only want to allow LDAP but not LiveJournal users (or vice versa), simply remove the class file for the unwanted service(s). See Remote Authentication in glFusion for more information.
- User Login Method [OAuth]
- Allow (when set to true) users who already have an account with an OAuth-based service (eg. Facebook, LinkedIn, Twitter and others) to log into your glFusion site with the credentials they have established with that service. Enabling this option result in the display of one or more service-specific login buttons in the site login dialog(s). Please refer to our glFusion Remote Authentication wiki page for more information.
- Display Standard Auth First in Dropdown
- When there are multiple authentications methods, such as LDAP and local authentication, if this is set to True, it will display the local login option first in the method dropdown list.
- Enable Facebook OAuth Login Method
- Allow (when set to true) users to login to the site using their Facebook account. Note: You must create a Facebook Application ID (consumer key) and Application Secret (consumer secret) for your site.
- Facebook OAuth Application ID
- Required to use the Facebook OAuth login method. Please visit the Facebook Developers Page to create an Application ID (consumer key) string that is specific to your site/URL. Please refer to our glFusion OAuth Authentication for Facebook wiki page for more information.
- Facebook OAuth Application Secret
- Required to use the Facebook OAuth login method. Please visit the Facebook Developers Page to create an Application Secret (consumer secret) string that is specific to your site/URL. Please refer to our glFusion OAuth Authentication for Facebook wiki page for more information.
- Enable LinkedIn OAuth Login Method
- Allow (when set to true) users to login to the site using their LinkedIn account. Note: You must create a LinkedIn API Key (consumer key) and Secret Key (consumer secret) for your site.
- LinkedIn OAuth API Key
- Required to use the LinkedIn OAuth login method. Please visit the LinkedIn Developers Page to create a LinkedIn API Key (consumer key) string that is specific to your site/URL. Please refer to our glFusion Remote OAuth for LinkedIn wiki page for more information.
- LinkedIn OAuth Secret Key
- Required to use the LinkedIn OAuth login method. Please visit the LinkedIn Developers page to create a Secret Key (consumer secret) string that is specific to your site/URL. Please refer to our glFusion OAuth Authentication for LinkedIn wiki page for more information.
- Enable Google OAuth Login Method
- Allow (when set to true) users to login to the site using their Google account credentials. Note: You must create a Google Consumer Key and Consumer Secret for your site.
- Google OAuth Consumer Key
- Required to use the Google OAuth login method. Please visit the Google Application Page to create a Google Consumer Key string that is specific to your site/URL. Please refer to our glFusion OAuth Authentication for Google wiki page for more information.
- Google OAuth Consumer Secret
- Required to use the Google OAuth login method. Please visit the Google Application Page to create a Google Consumer Secret string that is specific to your site/URL. Please refer to our glFusion OAuth Authentication for Google wiki page for more information.
- Enable Microsoft OAuth Login Method
- Allow (when set to true) users to login to the site using their Microsoft Live account credentials. Note: You must create a Microsoft Consumer Key and Consumer Secret for your site.
- Microsoft OAuth Consumer Key
- Required to use the Microsoft OAuth login method. Please visit the Microsoft Application Page to create a Microsoft Consumer Key string that is specific to your site/URL. Please refer to our glFusion OAuth Authentication for Microsoft wiki page for more information.
- Microsoft Oauth Consumer Secret
- Required to use the Microsoft OAuth login method. Please visit the Microsoft Application Page to create a Microsoft Consumer Secret string that is specific to your site/URL. Please refer to our glFusion OAuth Authentication for Microsoft wiki page for more information.
- Enable GitHub OAuth Login
- Allow (when set to true) users to login to the site using their GitHub account. Note: You must create a GitHub Client ID and Client Secret for your site.
- GitHub Client ID
- Required to use the GitHub login method. Please visit the GitHub Application Page to create the Client ID.
- GitHub Client Secret
- Required to use the GitHub login method. Please visit the GitHub Application Page to create the Client Secret.
Password Rules
- Minimum Password Length
- The minimum length allowed for a password. To disable minimum length validation, set this to 0.
- Maximum Password Length
- The maximum length allowed for a password. To disable maximum length validation, set this to 0.
- Require Number
- If set to TRUE, passwords will be required to contain at least 1 number.
- Require Letter
- If set to TRUE, passwords will be required to contain at least 1 letter.
- Require Upper Case Letter
- If set to TRUE, passwords will be required to contain at least 1 upper case letter.
- Require Lower Case Letter
- If set to TRUE, passwords will be required to contain at least 1 lower case letter.
- Require Special Character
- If set to TRUE, passwords will be required to contain at least 1 special character such as ! # $ % ^ & *.
Login Settings
- Record Last Login
- Whether to keep track of when a user last logged in (= true) or not (= false).
- Login Required
- Login is required to access any part of the site. When set to TRUE, this overrides the following settings. When you only want to block access to certain parts of the site, set this to FALSE and select from the following settings.
- Submit Login Required
- When set to TRUE, only registered users can submit stories and items handled by plugins, e.g. links and events
- Stats Login Required
- When set to TRUE, only registered users can access the site stats
- Search Login Required
- When set to TRUE, only registered users can use the advanced search.
- Profile Login Required
- When set to TRUE, only registered users can view another user's profile
- E-mail User Login Required
- When set to TRUE, only registered users can use the email submission form to send an email to another user
- E-Mail Story Login Required
- When set to TRUE, only registered users can email stories
- Directory Login Required
- When set to TRUE, only registered users can access the list of past articles
- Password Speed Limit
- Minimum delay between two requests for a new password, in seconds.
- Max. Login Attempts
- Maximum number of login attempts before the speedlimit (see below) kicks in and further logins are blocked for the given amount of time.
- Login Speed Limit
- How many seconds have to pass before another login attempt can be made after Max Login Attempts (see above) login attempts have failed.
User Submission
- Disable New User Registration
- When set to true completely disables all options to sign up as a new user.
- Enable Custom Registration
- When set to true, glFusion will let you use your own signup form for new user registrations. Please see the file lib-custom.php that ships with glFusion for an example.
- User Submission Queue
- Enable (TRUE) or disable (FALSE) the user submission queue (i.e. new users must be approved before they receive their password)
- Registration Type
- Generate Password will automatically generate a random password for the user upon registration, and send it to them in the welcome email. User Enters Password will prompt the user to create their own password when they fill out the registration form, and will require them to click on a verification link sent in the welcome email.
- Automatic Allow Domains
- When the user submission queue is enabled this can contain a comma-separated list of domain names from which user submissions will not be queued (but approved automatically). Regular expressions are also allowed and interpreted.
Example: 'mycompany.com,myothercompany.com'
- Automatic Disallow Domains
- This is the opposite of Automatic Allow Domains (see above): A list of domain names that are not allowed in email addresses of new users. Note that this list is always used, even when the user submission queue has been switched off. Again, regular expression can be used.
Example disallow email addresses with a certain domain name and from any ”.edu” domain: 'somebaddomain.com,\.edu$'
- Full Name option on registration form?
- This controls whether there will be a "Full Name" field shown on the user registration form. The options are:
- No: The new user will not be able to enter a full name during registration. This matches the method used by glFusion.
- Optional: The user will be able to enter a full name during registration, but is not required to do so.
- Required: The user will be required to enter a full name before submitting the registration form.
- Minimum Username Length
- The minimum allowed length of a username.
Submission Settings
- Story Submission Queue
- Enable (TRUE) or disable (FALSE) the story submission queue
- Only allow submission to topics with write permission
- If false, a user can submit a story to any topic, regardless of the topic permissions (the story will go to the submission queue if enabled). If true, a user can only submit stories to a topic that they have write permissions to. If true, this will disable anonymous submissions since a non-logged-in user will never have write permissions to a topic.
- List Draft Stories
- When set to TRUE, this will display an additional block on the submissions page (moderation.php) that lists all the stories that have the 'draft' flag set.
- Default Post Mode
- Sets the default submission mode to 'html' or 'plaintext'
- HTML or Text mode when mailing users / stories
- Sets the default mode to 'html' or 'plaintext' for emailing users or stories.
- Post Speed Limit
- Minimum delay between submissions in seconds. This helps prevent Denial of Service (DOS) attacks
- Skip Preview in Posts
- If TRUE, allows submission of stories and comments without previewing (i.e. the submission form will always have a Preview and a Submit button).
Comments
- Automatically close comments (default)
- Default setting for "Automatically Close Comments".
- Days to close comments
- Default number of days to set the Comment Close date on new stories.
Rating Options
- Rating Speed Limit
- Number of seconds a user must wait between each rating
Spam-X
- Spam-X Actions
- Tells glFusion's Spam-X plugin what to do when a spam post has been detected. The value is the sum of all values that uniquely identify the Spam-X modules that should be executed. E.g. the “delete” action module uses 128, the “email admin” module uses 8, so if both modules should be executed, this option should be set to 128 + 8 = 136.
Images
Image Library
- Image Library
- Set this to either 'graphicsmagick', 'imagemagick', 'netpbm', or 'gdlib' if images should be resized during upload.
- Path to GraphicsMagick / ImageMagick Executables
- If you chose 'graphicsmagick' or 'imagemagick' for the Image Library above, then this should hold the full path to the convert executable (from the ImageMagick package), e.g. '/usr/bin/'. You will need a fairly recent version of GraphicsMagick or ImageMagick for this to work (version 5.4.9 or newer is recommended).
- Path to Netpbm
- If you chose 'netpbm' for Image Library and above, then this should hold the complete path to the directory where the binaries from the netpbm package are kept, e.g. '/usr/bin/netpbm/'. Note that the path must end in a slash. Precompiled binaries of the netpbm package for various platforms can be downloaded from the Homepage of the Gallery project.
- Enable JHEAD
- JHEAD is a command line utility that will save the EXIF/IPTC data in your images. By enabling JHEAD support, glFusion will be able to save all the EXIF/IPTC data even if it has to resize the original image, or remove the original image (EXIF/IPTC data will be saved in the display image).
- Path to jhead executable
- This is the absolute path on your server where the jhead binary on your server.
- Enable jpegtrans
- JPEGTRANS is a lossless tool for manipulating JPG images. It will allow for images to be rotated on line without losing any quality.
- Path to jpegtrans executable
- This is the absolute path on your server where the jpegtrans binary on your server.
Upload
- Keep Unscaled Image
- Set this to TRUE if you want glFusion to keep the original, unscaled images after upload. The smaller image will then be used as a thumbnail and will link to the original image. Note that this may use a lot of disk space (depending on the size of your images).
- Allow User Scaling
- When unscaled images are kept (see above), this option lets the user chose between using the scaled or unscaled image in the story, i.e. enables the [unscaledX] image tag (in addition to the [imageX] tag).
- JPEG Quality Factor
- When converting images, the JPEG quality setting to use. Lower numbers provide lower resolution, but smaller file sizes.
- Debug Image Uploading
- When set to true, this option enables debugging output to be written into glFusion's error.log file during the upload of an image. This is useful to track down problems with the image upload.
Images in Articles
- Max. Image Width
- Maximum width of an image in pixels. If it exceeds this, it is either rejected or resized (depending on the setting of Image Library above).
- Max. Image Height
- Maximum height of an image in pixels. If it exceeds this, it is either rejected or resized (depending on the setting of Image Library above).
- Max. Image Size
- Maximum size of an image in bytes. If it exceeds this, it is rejected (even if you're using a graphics package to resize images).
Topic Icons
- Max Topic Icon Width
- Maximum width of a topic icon in pixels. If it exceeds this, it is either rejected or resized (depending on the setting of Image Library
- Max Topic Icon Height
- Maximum height of a topic icon in pixels. If it exceeds this, it is resized.
- Max Topic Icon Size
- Maximum size of a topic icon in bytes. If it exceeds this, it is rejected (even if you're using a graphics package to resize images).
Photos
- Max Photo Width
- Maximum width of a user photo in pixels. If it exceeds this, it is resized .
- Max Photo Height
- Maximum height of a user photo in pixels. If it exceeds this, it is resized.
- Max Photo Size
- Maximum size of a user photo in bytes. If it exceeds this, it is rejected (even if you're using a graphics package to resize images).
- Force Photo Width
- This option, when enabled, will only apply when displaying a user photo. The <img> tag for the user photo will be emitted with a max. width, as specified by this option. This means that the actual photo can still be larger, but will only be displayed smaller. This is useful for cases where you don't want oddly shaped user photos to break your page's layout (e.g. in a forum).
- Default Photo
- When enabled, this option should point to an image (full URL required!) that should be displayed for users without a user photo. When this option is not set and a user does not have a user photo (or an avatar) then glFusion will simply not display anything.
Gravatar
- User Gravatar
- If enabled (set to true), a user's avatar image will be requested from gravatar.com if the user didn't upload a user photo (i.e. an uploaded photo always takes priority). Please note that this option may slow down your site on pages that display a lot of userphotos for different users (e.g. forum threads).
- Gravatar Rating Allowed
- Avatars submitted to gravatar.com are rated with the rating system used for movies (in the U.S.), i.e. the letters G, PG, R, or X. This option will let you chose the maximum allowed rating for an avatar. For example, a max. rating of R will make sure that no X-rated avatars will be displayed on your site (only G, PG, and R).
- Max logo height
- Maximum height, in pixels, of the logo image. If a logo is larger than this setting, it will be rejected.
- Max logo width
- Maximum width, in pixels, of the logo image. If a logo is larger than this setting, it will be rejected.
Languages and Locale
Language
- Language
- Name of your language file. Additional language files may be available for download at http://www.glfusion.org. If you translate a language file, please send it to us. Also see Localization below.
- Language Files
- For multi-lingual setups only: A list mapping language shortcuts ('en', 'de', etc.) to the glFusion language files to use.
- Languages
- For multi-lingual setups only: A list mapping language shortcuts ('en', 'de', etc.) to the language's native name (“English”, “Deutsch”, etc.). See language for more information.
Locale
- Locale
- Locale for the system. This defines both the language and the country that PHP will use when deciding how to display localized information such as dates (e.g. for the names of months).
- Date Format
- Date format used for most of the site, including story displays. See date formats below.
- Daytime Format
- Date format used when a shorter date is needed. See date formats below.
- Short Date Format
- Date format this is the shortest date. See date formats below.
- Date Only Format
- Short date format (day and month only), to be used e.g. in the Upcoming Events and Older Stories blocks. See date formats below.
- Time Only Format
- Format string for the time only, to be used e.g. on the Event Details page. See date formats below.
- Week Start
- First day of the week in the calendar. Can be either 'Sun' (Sunday) or 'Mon' (Monday).
- Hour Mode
- Which format to use when submitting or editing an object with a time setting (e.g. the publish time of a story). Can be 12 (for the 12 hour am/pm format) or 24 (for the 24 hour format).
- Thousands Separator
- Character to use between every group of thousands.
- Decimal Separator
- Character to use before decimals.
- Decimal Count
- How many decimal places to display.
- Timezone
- If your server is located in a different timezone, use this option to set your local (i.e. your own) timezone, so that the time and date on the site match your own. This option is known as the “timezone hack” and may not work on some servers.
Miscellaneous
Cookies
These variables define the names of all of glFusion's cookies. They
can easily be changed in case there's a name collision with the cookies
used by some other software package that you may use on your site.
- Session Cookie Name
- Name of the cookie that stores the session ID.
- Permanent Cookie Name
- Name of the permanent cookie.
- Session IP Validation
- Determines how much of the users IP is used to validate a session; All compares the complete address, A.B.C the first x.x.x, A.B the first x.x, None disables checking.
- Password Cookie Name
- Name of the password cookie.
- Theme Cookie Name
- Name of the theme cookie.
- Language Cookie Name
- Name of the language cookie.
- Timezone Cookie Name
- Name of the timezone cookie.
- Cookies embed IP?
- Session ID to contain IP address of user as well as random number. This is more secure but will more than likely require dialed up users to login each and every time. (FALSE=no, TRUE=yes)
- Permanent Timeout
- Permanent cookie timeout in seconds (28800 = 8 hours).
- Session Timeout
- Session cookie timeout (in seconds). Basically the amount of time with no activity before the user is logged out.
- Cookie Path
- Cookie path. The path on the server in which the cookie will be available on. If set to '/', the cookie will be available within the entire domain. If set to '/foo/', the cookie will only be available within the /foo/ directory and all sub-directories such as /foo/bar/ of domain. The default value is the current directory that the cookie is being set in.
- Cookie Domain
- The domain that the cookie is available. glFusion will attempt to guess the correct value for this setting (based on the 'site_url' variable). The (sub)domain that the cookie is available to. Setting this to a subdomain (such as 'www.example.com') will make the cookie available to that subdomain and all other sub-domains of it (i.e. w2.www.example.com). To make the cookie available to the whole domain (including all subdomains of it), simply set the value to the domain name ('example.com', in this case).
- Cookie Secure
- Only set to TRUE if your site uses HTTPS.
Miscellaneous
- Notifications
- Send an email notification to site_email when a new story, comment, trackback or pingback has been submitted or a new user has registered with the site.
In this web-based configuration tool, click the '+' button to add each item as an individual element. Do not include single or double quotes.
- Cron Schedule Interval
- glFusion can emulate a cronjob, i.e. trigger a certain action at a given time. The code to be executed can be provided by a plugin or through the CUSTOM_runScheduledTask function in your lib-custom.php. The value given is in seconds and specifies the interval in which the code should be executed.
Please note that to trigger this action, you will need to have someone visit your site at around the specified time. On a site with few visitors, the code may only be executed with considerable delay. Set to 0 to disable.
- Disable Autolinks
- If set to TRUE, disables the auto tags. I.e. links using the [story:] etc. syntax are not interpreted any more.
- Open External Links in new Window
- If set to TRUE, external links used in Forum posts, BBCode [url] tags or automatically generated links will open in a new window.
Debug
- Root Debugging
- When a PHP error occurs, glFusion's error handler will only display the actual error message to members of the Root group (to prevent leakage of possibly sensitive information). When set to true, this information will be displayed to all users. Use only for debugging purposes!
- Log 404 - Not Found Errors
- If set to TRUE, all 404 Not Found errors will be logged to the 404.log file.
- Oauth Debug Logging
- If this is set to true - verbose log messages of the Oauth login process will be logged to the glFusion error.log file. This option is useful if you are experiencing issues with any of the Oauth protocols. Debug info is logged in the error.log file.
- HTML Filter Debug Logging
- If this is set to true - the HTML filter will log details on which HTML elements and attributes are filtered. Debug information is logged in the error.log file.
Daily Digest
- Daily Digest Enabled
- Let users get stories e-mailed to them (FALSe=no, TRUE=yes), aka Daily Digest. Please note that this requires cron and the use of PHP as a shell script.
- Length of Stories
- When emailstories (above) is enabled, send only the title and the link to the new stories (0), or send the entire introtext (1) or send the first n characters from the introtext (where n = any other number)
- Enable for New Users
- When set to TRUE, new users will be subscribed to the daily digest automatically when they register with the site.
HTML Filtering
- Allow EMBED Object
- Allow the EMBED object in HTML stories and posts. This allows you to embed YouTube videos and other streaming videos in stories. (Obsolete).
- Skip HTML Filter for Root
- When set to TRUE, this will allow members of the Root group to use all HTML in their posts. No HTML filtering will be done for any user in the Root group.
- Default set of allowed HTML
- The default HTML tags that are allowed. These tags can be used anywhere by all users. Comma separated list of allowed HTML tags.
- HTML allowed in stories
- The set of HTML tags allowed when entering stories. Generally, this is used when you allow regular users to submit stories. A comma separated list.
- Additional HTML allowed for Root users
- Additional HTML tags that are only allowed for Root users - a comma separated list.
Censoring
- Censor Mode
- Censor submissions and comments (FALSE=no, YES=yes)
- Censor Replace Text
- Text to replace a censored word with
- Censor List
- List of words to remove and replace with the replacement text.
IP Lookup
- IP Lookup
- The IP addresses of comment posters are logged and displayed for admin users. When this variable is set to point to a service that can do IP address lookups, it's possible to lookup the owner of an IP address by clicking on it, making it easier to report abuse to ISPs, etc. This setting should hold the complete URL to the lookup service, with a '*' marking the place where the IP address should go. It's also possible to use Tom Willet's NetTools package, in which case the correct setting would be this setting should be set to "$_CONF['site_url'] . '/nettools/whois.php?domain=*';"
Story Default Permission
- Story Default Permissions[0] (Owner Permissions)
- The default Owner permissions for the Story editor. The settings here will determine what permissions are checked (Read only, or Read/Write), or unchecked (No access) by default in the Owner box of the Permissions panel in the Story editor. Options are No access, Read only, or Read/Write.
- Story Default Permissions[1] (Group Permissions)
- The default Group permissions for the Story editor. The settings here will determine what permissions are checked (Read only, or Read/Write), or unchecked (No access) by default in the Group box of the Permissions panel in the Story editor. Options are No access, Read only, or Read/Write.
- Story Default Permissions[2] (Member Permissions)
- The default Member permissions for the Story editor. The settings here will determine what permissions are checked (Read only, or Read/Write), or unchecked (No access) by default in the Members box of the Permissions panel in the Story editor. Options are No access, Read only, or Read/Write.
- Story Default Permissions[3]
- The default Anonymous permissions for the Story editor. The settings here will determine what permissions are checked (Read only, or Read/Write), or unchecked (No access) by default in the Anonymous box of the Permissions panel in the Story editor. Options are No access, Read only, or Read/Write.
Topic Default Permission
- Topic Default Permissions[0]
- The default Owner permissions for the Topic editor. The settings here will determine what permissions are checked (Read only, or Read/Write), or unchecked (No access) by default in the Owner box of the Permissions panel in the Topic editor. Options are No access, Read only, or Read/Write.
- Topic Default Permissions[1]
- The default Group permissions for the Topic editor. The settings here will determine what permissions are checked (Read only, or Read/Write), or unchecked (No access) by default in the Group box of the Permissions panel in the Topic editor. Options are No access, Read only, or Read/Write.
- Topic Default Permissions[2]
- The default Member permissions for the Topic editor. The settings here will determine what permissions are checked (Read only, or Read/Write), or unchecked (No access) by default in the Members box of the Permissions panel in the Topic editor. Options are No access, Read only, or Read/Write.
- Topic Default Permissions[3]
- The default Anonymous permissions for the Topic editor. The settings here will determine what permissions are checked (Read only, or Read/Write), or unchecked (No access) by default in the Anonymous box of the Permissions panel in the Topic editor. Options are No access, Read only, or Read/Write.
Block Default Permission
- Block Default Permissions[0]
- The default Owner permissions for the Block editor. The settings here will determine what permissions are checked (Read only, or Read/Write), or unchecked (No access) by default in the Owner box of the Permissions panel in the Block editor. Options are No access, Read only, or Read/Write.
- Block Default Permissions[1]
- The default Group permissions for the Block editor. The settings here will determine what permissions are checked (Read only, or Read/Write), or unchecked (No access) by default in the Group box of the Permissions panel in the Block editor. Options are No access, Read only, or Read/Write.
- Block Default Permissions[2]
- The default Member permissions for the Block editor. The settings here will determine what permissions are checked (Read only, or Read/Write), or unchecked (No access) by default in the Members box of the Permissions panel in the Block editor. Options are No access, Read only, or Read/Write.
- Block Default Permissions[3]
- The default Anonymous permissions for the Block editor. The settings here will determine what permissions are checked (Read only, or Read/Write), or unchecked (No access) by default in the Anonymous box of the Permissions panel in the Block editor. Options are No access, Read only, or Read/Write.
Spam / Bot Protection
- BB2 Enabled
- Set this to true to enable Bad Behavior 2 plugin protection.
- Enable Automatic Banning
- If set to true, IPs will be automatically banned if they fail the CAPTCHA entry 5 times, or if a post fails the Cross Site Forgery Check. IPs will be banned for number of hours configured below.
- Log Auto Ban Actions
- If set to true, Bad Behavior2 will log each time it performs an auto ban. It will log the date / time, IP, and reason.
- Number of hours to ban IP
- The number of hours to ban an IP that has been automatically banned.
- Strict Checking
- Bad Behavior operates in two blocking modes: normal and strict. When strict mode is enabled, some additional checks for buggy software which have been spam sources are enabled, but occasional legitimate users using the same software (usually corporate or government users using very old software) may be blocked as well. It is up to you whether you want to have the government reading your blog, or keep away more spammers.
- Verbose Logging
- Turning on verbose mode causes all HTTP requests to be logged. When verbose mode is off, only blocked requests and a few suspicious (but permitted) requests are logged. Verbose mode is off by default. Using verbose mode is not recommended as it can significantly slow down your site; it exists to capture data from live spammers which are not being blocked.
- Logging Enabled
- You can disable logging entirely, but this is not recommended since it may cause additional spam to get through.
- HTTP BlackList Key
- Bad Behavior is capable of using data from the http:BL service provided by Project Honey Pot to screen requests. This is purely optional; however if you wish to use it, you must sign up for the service and obtain an API key. To disable http:BL use, remove the API key from your settings.
- http:BL Threat Level
- This number provides a measure of how suspicious an IP address is, based on activity observed at Project Honey Pot. Bad Behavior will block requests with a threat level equal or higher to this setting. Project Honey Pot has more information on this parameter.
- http:BL Maximum Age
- This is the number of days since suspicious activity was last observed from an IP address by Project Honey Pot. Bad Behavior will block requests with a maximum age equal to or less than this setting. Project Honey Pot (http://www.projecthoneypot.org/threat_info.php) has more information on this parameter.
- Allow Offsite Forms
- Bad Behavior normally prevents your site from receiving data posted from forms on other web sites. This prevents spammers from, e.g., using a Google cached version of your web site to send you spam. However, some web applications such as OpenID require that your site be able to receive form data in this way.
- Reverse Proxy Support (i.e.; CloudFlare)
- Enable this option if your website is behind a reverse proxy or load balancer. For example, if you use CloudFlare service or another proxy server, set this to True.
- Reverse Proxy Addresses
- If you know the IP addresses of your proxy server(s) or the load balancers, enter them here. For services such as CloudFlare, you can leave this blank.