glFusion Wiki

Site Tools


glfusion:configuration:site

Site

The Site Configuration section controls items such as the site URL, how URLs are written, etc. Generally these options should not change often.


Site


Site URL
Base URL for your site (no trailing slash)
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.

URL rewriting means that the URLs will look like this

http://www.glfusion.org/article.php/20021022234959146

Instead of this

http://www.glfusion.org/article.php?story=20021022234959146

While some search engines will pick up the second form, Google seems to prefer the first format and completely ignores the second format.

Rewrite Rules for Nginx webserver - place these in the location block

rewrite ^/article.php/(.*)$ /article.php?story=$1 last; 
rewrite ^/staticpages/index.php/(.*)$ /staticpages/index.php?page=$1 last; 
rewrite ^/page.php/(.*)$ /page.php?page=$1 last; 
rewrite ^/links/portal.php/link/(.*)$ /links/portal.php?what=link&item=$1 last;  
rewrite "^/directory.php/(.*)/(\d{1,})/(\d{1,})$" /directory.php?topic=$1&year=$2&month=$3 last;

Mail Options


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.
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 binary.
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 Options


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 database backup files are stored
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.

Pear


Have Pear
Whether you have PEAR installed on your server (= true) or not (= false). When set to false, glFusion will use the PEAR packages installed in path_pear (see below)
Path Pear
When Have Pear (see above) is set to false, this is the path where glFusion expects to find the PEAR packages it requires (e.g. PEAR::Mail for sending emails).

Search Options


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 tablular format.
Page Limits
Defined the valid page options for the Number of items per page drop down 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
If no data description is available, display this text.
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 following information to glfusion.org:
  • Site URL
  • glFusion Version
  • PHP Version
  • Database Version
This data is only used by the glFusion team to gain a better understanding of how many sites are running glFusion and the PHP / MySQL versions used. This data is never sold or shared with any other source. If disabled, no information is passed to or stored by glFusion.org.
glfusion/configuration/site.txt · Last modified: 2017/04/12 21:11 (external edit)

Page Tools