Home « Server software «
Documentation: skins/configure.php
skins/configure.php - The configuration panel for skins
This page is called to change rendering parameters of the YACS server.Parameters are grouped as follows:
- meta-information - most are used in template files
- general rendering options - enable or disable some components
- front page - configure the home page as you wish
- article pages - parameters specific to articles
- image processing
Meta-information parameters:
*
site_name - used everywhere to reference your server.
If this parameter is empty, YACS uses the network host name instead (eg, 'www.myserver.com').
This parameter is appended to each <title> attribute.
It is also used extensively in meta attributes used at the main index page (eg, DC.title) and
in newsfeeds (eg, it is the default value for feed title).
Also used at about.php, the description page for your site.
Lastly, it is also the default value for subject of new newsletters.*
site_slogan - may be displayed at every page, in template.php.
During YACS installation a default slogan is proposed.
This parameter may be set to an empty string if you don't want any slogan to appear.*
site_description - appearing in a <meta> tag of all pages.
It is also the default value for channel description in newsfeeds.
Also used at about.php, the description page for your site.
During YACS installation a default slogan is proposed.
This parameter may be set to an empty string if you don't want any description to appear.*
site_keywords - appearing in a <meta> tag*
site_email - webmaster mail address - warning, this address may be spammed*
site_copyright - used in about.php*
site_owner - used in about.php*
revisit_after - appearing in a <meta> tag (default: 7 days)*
site_position - the latitute and longitude, separated by a comma.
See either GeoTags Search Engine
or Free Geocoding Service for 22 Countries
for more information.*
site_head - inserted as-is in the <head> section of each page*
site_icon - the icon for favorites; may be displayed at every page, in template.phpGeneral rendering options:
*
site_navigation_maximum - The maximum number of navigation boxes to display on page side.
Default value is 7. This parameter should be used in template file.*
site_extra_maximum - The maximum number of extra boxes to display on page side.
Default value is 7. This parameter is used in various scripts.*
with_author_information - Add links to author pages in lists of articles.
By default this information is available only at article pages.*
pages_without_feeds - Do not list feeds in sections, categories, and articles*
pages_without_reference - To avoid self-referencing*
pages_without_bookmarklets - Do not display javascript tools*
pages_without_history - To avoid the display of visited pagesParameters for the main panel of the front page:
*
cover_at_home - Either 'full', 'body' or 'none'.
By default YACS displays the title and the content of the cover article at the front page.
Select 'body' to mask the title of the cover page.
And use 'none' to not display any cover article.*
sections_count_at_home - Specify explicitly the number of sections to list at the front page.
Default value is 5.*
sections_at_home - Either 'menu', or 'map1', or 'map2', or 'none', or some section id.
By default YACS lists top sections as a menu bar.
Use 'map1' or 'map2' to reflect the site map at the front page.
Else put the id of the section you would like to focus on at the front page.
Or disable explicit listing of sections if you use a skin that features dynamic tabs, based on sections.*
flash_at_home - Insert a Flash object to animate recent titles*
gadget_boxes_at_home - Display gadget boxes at the front page.
Due to the special layout used for gadget boxes, there is a fixed maximum of 6 gadget boxes.*
collections_at_home - Turn this host to a media server.
If this parameter is set to 'Y', YACS will list available collections in a gadget box.*
home_layout - Select the layout to use for articles at the home page.
This parameter may have effect at other pages on occasion (e.g., boxesandarrows).
Following values may be selected:
daily- Make titles out of publication dates.
newspaper- Focus on the last published article, and list some articles published previously.
boxesandarrows- List the last ten most recent pages.
slashdot- List the last ten most recent pages.
decorated- A compact list of the ten most recent articles.
compact- A simple list of titles.alistapart- Display only the most recent published page.
no_articles- Do not mention recent articles.
*
articles_count_at_home - Specify explicitly the number of articles to list at the front page.
By default YACS uses values given by selected layouts.*
home_with_recent_files - List most recent files at the front page*
home_with_recent_links - List most recent links at the front pageParameters for the extra panel of the front page:
*
featured_at_home - Either 'static', or 'scroll', or 'rotate', or 'none'.
By default YACS lists featured articles as a static list.
Use 'scroll' to animate things.*
featured_count_at_home - Specify explicitly the number of featured articles to list at the front page.*
news_at_home - Either 'static', or 'scroll', or 'rotate', or 'none'.
By default YACS lists news articles as a static list.
Use 'scroll' to animate the news.*
news_count_at_home - Specify explicitly the number of news to list at the front page.*
home_with_older_articles - List in a side box articles older that those featured in the
main area.*
home_with_peering_servers - Display a list of servers that have pinged us recently.*
home_with_random_articles - Display a list of random pages.*
home_with_recent_poll - List the current poll at the front page*
home_with_top_articles - List most read articles at the front page*
home_with_top_files - List most fetched files at the front page*
home_with_top_links - List most clicked links at the front pageParameters for articles:
*
with_anonymous_side_tools - To foster registration*
with_bottom_tools - Display, or not, conversion tools*
with_anonymous_bottom_tools - Spread published information more largelyParameters for image processing:
*
standard_width - the maximum width, in pixels, for images that have to be resized.
Default value is 640 pixels.*
standard_height - the maximum height, in pixels, for images that have to be resized.
Default value is 640 pixels.*
avatar_width - the maximum width, in pixels, for avatars.
Default value is 80 pixels.*
avatar_height - the maximum height, in pixels, for avatars.
Default value is 80 pixels.*
thumbnail_threshold - size in bytes that require a thumbnail image.
Default value is 20480 bytes.*
thumbnail_width - the maximum width, in pixels, for thumbnail images.
Default value is 60 pixels.*
thumbnail_height - the maximum height, in pixels, for thumbnail images.
Default value is 60 pixels.*
thumbnails_without_caption - If set to 'Y', only a hovering title is provided.
Else, which is the default, image title is added to thumbnail as caption.Access to this page is reserved to associates.
Configuration information is saved into
skins/parameters.include.php.
If YACS is prevented to write to the file, it displays parameters to allow for a manual update.The file
skins/parameters.include.php.bak can be used to restore
the active configuration before the last change.If the file
demo.flag exists, the script assumes that this instance
of YACS runs in demonstration mode.
In this mode the edit form is displayed, but parameters are not saved in the configuration file.This script is a reference file of this system.
Voir aussi:
Licence: GNU Lesser General Public License
Auteurs:
- Bernard Paques bernard.paques@bigfoot.com
Testeurs:
- Tof christophe@battarel.com
- Pat
- Natice
- FabriceV
- Aleko
- Guillaume Perez
- Mark
