local.conf Options for Project Owners
The file local.conf is a configuration file for customising how your project content is presented. Every new project should have one in the www/ directory, and any other directory can have one too.
The latest options will always be available in the templates copy of local.conf
NOTE: If any of the variables below are not defined in your copy of local.conf, the default value is assumed..
If you have any questions or comments, please contact us.
| NAME | DESCRIPTION | VALUES (DEFAULT IN BOLD) |
|---|---|---|
| Template System | ||
| $local_conf_serve_as_is | To completely turn off all site branding and wrapping and have your page content stand alone. | OFF - site branding and wrapping are present. ON - site branding and wrapping are not present. |
| $local_conf_no_wrap | Turning site branding on and off. This includes the
mozdev banner, the navigation panel and the default stylesheet. This only affects the look and feel - there is still some html wrapping. To turn off all wrapping use $local_conf_serve_as_is. |
OFF - site branding is present. ON - site branding is not present. |
| $local_conf_nav_off | Show/Hide the sidebar panel on your project pages. | OFF - the sidebar shows. ON - the sidebar does not show. |
| $local_conf_use_local_nav | Use a default page for the sidebar | OFF - the
mozdev sidebar shows.
requires $local_conf_nav_off=OFF ON - Nav_Column.%PROJECT% is used. |
| $local_conf_use_local_header | Use a default page for the header | OFF - the
mozdev header shows. ON - html_body.html |
| $local_conf_use_local_footer | Use footer.html from the project root instead of the mozdev default. | OFF - the default
mozdev footer. ON - footer.html. |
| Styling | ||
| $local_conf_skin | The stylesheet(s) to use for your project pages. This option is disabled by $local_conf_no_wrap and $local_conf_style_2004 |
default.css A URI to your own CSS file. |
| $local_conf_style_2004 | Whether to use the Mozdev theme created in 2004. | OFF for projects before 2004; ON for projects created after 2004. |
| $local_conf_ignore_holidays | mozdev sometimes uses a different theme for special occasions. You can ignore this and use the default style. | ON - always use default style. OFF - Use altered theme. You can choose from a selection of themes by setting the $now variable. More details... |
| $local_conf_body_class | The CSS class to additionally specify on the <body /> tag. | empty |
| $local_conf_body_id | The id attribute to specify on the <body /> tag. | empty - generated per-page |
| $local_conf_body_id_override | Flag to override the generated or specified body id attribute on the <body /> tag. | OFF - use the generated
or specified id tag on the body tag ON - only use a single preset body tag of "mozdev-org" |
| $local_conf_home_override | Flag to set the CSS class on the <body /> tag on index pages to "home" instead of "index". | OFF - CSS class on
body tag on index pages is set to "index" ON - CSS class on body tag on index pages is set to "home" |
| Automatic pages | ||
| $local_conf_auto_generate_memberlist | Determins whether your members.html page is auto-generated | ON - the
member list is created OFF - the member list is not created |
| $local_conf_no_no_commits_message | Turns off the printing of the 'There are no new commits today' message on a project's source.html page. | OFF - the message appears. ON - remove the message. |
| $local_conf_last_updated | Toggle the CVS commit view that shows up in the 'Last Updated' section on the mozdev homepage. | ON - your project shows up. OFF - your project does not show up. |
| $local_conf_use_local_error_pages | Override the default mozdev 404 File Not Found error page | OFF - standard url here ON - 'error/404.html', unless $local_conf_error_page is set. |
| $local_conf_error_page | Use a customised 404 error page when user visits a file that does not exist on your project. The path is relative to PROJECTNAME/www. | n/a |
| Feeds | ||
| $local_conf_commits | Toggle the CVS commit view that shows up in the 'Last Updated' section on the mozdev homepage and the 'Today's CVS commits' list on the source.html page in your project | ON - your commits show up. OFF - your commits do not show up. |
| $local_conf_commit_feed | Toggle whether the CVS commit log RSS feed and link are active for your project. | ON - The feed is active. OFF - The feed and link are disabled. |
| $local_conf_commit_feed_link | Toggle whether the link to the CVS commit log RSS feed is rendered. | ON - The link is rendered requires $local_conf_commit_feed=ON OFF - The link is not rendered |
| $local_conf_download_file_feed | Toggle whether the download file RSS feed and link are active for your project. | ON - The feed is active. OFF - The feed and link are disabled |
| $local_conf_download_file_feed_link | Toggle whether the link to the download file RSS feed is rendered. | ON - The link is rendered requires $local_conf_download_file_feed=ON OFF - The link is not rendered |
| $local_conf_download_file_min_age | The minimum age (seconds) of files to show in the feed. | 14400 - Files under 4 hours old won't show up in the feed. Any integer (0 for no delay) |
| Other... | ||
| $local_conf_mime_types | Will send the proper MIME-type for a file based on its extension. It is applied to the same directory and all sub-directories of the location where local.conf lives. The MIME-type information is sent via the PHP header. | OFF - MIME values not sent. ON - MIME values sent. |
| $local_conf_show_notes_form | Open up your NOTES[2] pages to comment spam. | OFF - Form is not shown. ON - Form shown. |
| $local_conf_project_html_lang | Allows alteration of the language in the <html lang="en"> tag | en ISO 639 alternative. |
| $local_conf_doctype_xhtml | Sets whether the project is being displayed with an xhtml-compliant doctype. When set the $GLOBALS['x_end'] variable is set to " /" and can be used at the end of entities that should be properly closed like <img /> and <input /> and in all Mozdev-generated templates. | OFF - HTML4-compliant pages |
| $local_conf_drupal_css | Sets a custom CSS file to use inside your project's Drupal instance. Note: this variable can only be set from your project's main local.conf file. | /drupal.css |
| $local_conf_edit_in_place | Enables edit-in-place. This allows you to make changes to your project web site graphically directly from your browser without checking out the code and modifying the HTML manually. | OFF -
Edit-in-place is disabled ON - Edit-in-place is enabled |