GeekLog's server settings are configured in a text file called config.php.
It is necessary to edit this file to get your system running as well as
configuring it to your preferences. This file contains a set of variables
that are defined below:
Name of your language file. Additional language files may be
available for download at http://www.geeklog.net.
If you translate a language file, please send it to us. Also see Localization below.
Character encoding used by Geeklog when serving HTML pages or
sending email. Only used if the language file did not already set
another character encoding.
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. (0=no, 1=yes)
The domain that the cookie is available. Geeklog will attempt to guess the correct value for this setting (based on the 'site_url' variable). See the PHP manual for details.
These variables define the names of all of Geeklog'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.
Starting with Geeklog 1.3.9, Geeklog uses the PEAR::Mail class to send all
emails. You can then select whether emails should be sent through SMTP,
sendmail, or PHP's mail() function.
Within $_CONF['mail_settings'] you have the following
options:
Login is required to access any part of the site. When
set to 1, this overrides the following settings. When you only want to
block access to certain parts of the site, set this to 0 and select
from the following settings.
When user submission is enabled this can contain a comma-separated list
of domain names from which user submissions will not be queued (but
approved automatically).
Example: 'mycompany.com,myothercompany.com'
Send an email notification to $_CONF['site_email'] when a new
story, link, or event has been submitted or a new user has registered with
the site. The array() can hold any combination of the strings
'story', 'link', 'event', and 'user'
(separated by commas), depending on which notification(s) you want. Example:array('story','user'); would
send notifications when a new story has been submitted or a new user has
registered. No notifications would be sent for new links or events.
When set to 1, this will display an additional block on the
submissions page (moderation.php) that lists all the stories that
have the 'draft' flag set.
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)
If set to 1, users will be allowed to change their username
(login name). Stories and comments posted under the old username will
automatically show the new username.
If set to 1, 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".
When set to 1, 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.
When set to 1, 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.
When set to 1, 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.
Set this to either 'imagemagick', 'netpbm', or 'gdlib' if
images should be resized during upload. Leave as '' if you don't want
images to be resized or if you don't have those packages available.
If you chose 'imagemagick' for $_CONF['image_lib'] above,
then this should hold the complete path to the mogrify
binary (from the ImageMagick package), e.g. '/usr/bin/mogrify'.
You will need a fairly recent version of ImageMagick for this to work
(version 5.4.9 or newer is recommended).
If you chose 'netpbm' for $_CONF['image_lib'] 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.
Set this to 1 if you want Geeklog 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).
Geeklog can export its headlines to a so-called RSS feed (also known as an RDF feed). This will let you share your news with other sites (Hint: Create a Portal block from Geeklog's Block menu to import RSS/RDF news feeds from other sites).
Starting with Geeklog 1.3.9, RSS feeds can be created and configured from
Geeklog's Admin menu ("Content Syndication"). The following settings will only
be used as the default settings for any new feeds that you create from the
admin panel.
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).
Limit the number of stories in the RSS 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 chose the stories.
If this value is 1, then the entire introtext of the stories will be included in the RSS feed. Any number greater than one 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.
HTML tags and attributes that admin users are allowed to
use (in addition to those from user_html). Redefining a tag with
additional attributes will overwrite the definition from user_html.
Defines which protocols are allowed in links (i.e. HTML <a> tags). Note: The kses class used to filter these protocols has a hard-coded list of allowed protocols to which the above will be added. It is currently not possible to remove any of the default protocols (which include, for example, 'mailto:', 'gopher:', and 'news:').
Geeklog 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). Currently, this
feature is only supported for URLs to stories and by the Static Pages
plugin.
URL rewriting means that your URLs will look like this
While some search engines will pick up the second form, Google seems to
prefer the first format and completely ignores the second format.
Note: This feature may not work with all web servers. It
is known to work with Apache (all versions) and known not to work
with IIS (at least some versions). Please try it out before you go public
with your site.
Localizing GeekLog is fairly easy. All strings are contained in a
language file. The default file that ships with the tarball is english.php.
People interested in translating Geeklog to other languages are encouraged
to join the geeklog-translations
mailing list. All important information concerning translating Geeklog will
be posted there.
You can set the locale and date format in the config.php file. To set the
locale, set the variable to the proper string or if you leave it blank it
will pull the default locale from the operating system. The date formats
are handled by your locale. Isn't that smart? Locale names are OS
dependent. On most UNIX hosts, you can find locale codes in the
/usr/share/locale/locale.alias file and on some systems the command
locale -a will display all available locales on a system. If a
locale doesn't exist you can create it using the localedef command.
%a - abbreviated weekday name according to the current locale
%A - full weekday name according to the current locale
%b - abbreviated month name according to the current locale
%B - full month name according to the current locale
%c - preferred date and time representation for the current locale
%C - century number (the year divided by 100 and truncated to an integer, range 00 to 99)
%d - day of the month as a decimal number (range 00 to 31)
%D - same as %m/%d/%y
%e - day of the month as a decimal number, a single digit is preceded by a space (range ' 1' to '31')
%h - same as %b
%H - hour as a decimal number using a 24-hour clock (range 00 to 23)
%I - hour as a decimal number using a 12-hour clock (range 01 to 12)
%j - day of the year as a decimal number (range 001 to 366)
%m - month as a decimal number (range 1 to 12)
%M - minute as a decimal number
%n - newline character
%p - either `am' or `pm' according to the given time value, or the corresponding strings for the current locale
%r - time in a.m. and p.m. notation
%R - time in 24 hour notation
%S - second as a decimal number
%t - tab character
%T - current time, equal to %H:%M:%S
%u - weekday as a decimal number [1,7], with 1 representing Monday
%U - week number of the current year as a decimal number, starting with the first Sunday as the first day of the first week
%V - The ISO 8601:1988 week number of the current year as a decimal number, range 01 to 53, where week 1 is the first week that has at least 4 days in the current year, and with Monday as the first day of the week.
%W - week number of the current year as a decimal number, starting with the first Monday as the first day of the first week
%w - day of the week as a decimal, Sunday being 0
%x - preferred date representation for the current locale without the time
%X - preferred time representation for the current locale without the date
%y - year as a decimal number without a century (range 00 to 99)
%Y - year as a decimal number including the century
%Z - time zone or name or abbreviation
%% - a literal `%' character
The Geeklog Documentation Project
All trademarks and copyrights on this page are owned by their respective owners. GeekLog is copyleft.