Meza/Public config

Public config holds information okay to display to the world. Public config includes everything in the  directory. An example public config, as used by enterprisemediawiki.org, can be seen at https://github.com/enterprisemediawiki/emw.o-public-config

public.yml
is the primary configuration file for Meza. It holds settings that are okay to display publicly, in contrast to secret.yml that holds sensitive information. can be used to override anything in. See on Meza's GitHub repository.

Modifying LocalSettings.php
Meza generates  each time   is run, and therefore it is not possible to directly edit. Instead, configuration set in   defines how   will look. However, because MediaWiki has an essentially infinite number of settings that Meza can't possibly account for, Meza has the ability to add to the beginning and end of  via two directories.

preLocalSettings.d
Any  file within   will be included at the top of. The file  exists by default in Meza, and by default holds the following information:


 * is used to turn debug settings on for all wikis
 * is used to define whether email should be turned on
 * is used to define whether email should be turned on

One common addition to this file is. This is a quick way to apply common permissions schemes. For example,  can be set in to the following:


 * : Allow anonymous users to edit your wiki without logging in
 * : Allow anonymous users to view, but not edit, your wiki without logging in
 * : Only logged in users can view and edit
 * : Only logged in users can view, but not just anyone can edit. Users must be in group  to be able to edit.
 * : Even if a user has a valid username, they cannot view the wiki. They must first be added to the group . Additionally, in order to edit, users must be in the group.

The above permissions schemes are in ascending order of restrictiveness.

postLocalSettings.d
The directory  works similarly to   in that any   file in that directory will be included into. However, this directory's files will be loaded at the end of, and as such it is useful to override Meza's defaults, or defaults set by extensions.

Adding extensions
See Meza/Installing additional extensions

Settings for individual wikis
Within the public configuration directory there is a subdirectory. This holds the individual configurations for each wiki. These directories hold the image file  which is the logo in the top left of each wiki. Similarly you can modify  here. Additionally, each wiki can have pre-LocalSettings.php and post-LocalSettings.php files that are loaded just for that wiki, in the same way as described above for all wikis. See section.

Generating a properly sized logo.png and favicon.ico from a file
To generate properly-sized  and   from an existing larger image file, see issue #410 on GitHub.

Example: Adding a custom namespace to a wiki
If the wiki's ID was, add the following to that wiki's preLocalSettings,  : And create a postLocalSettings file like   if you want the content searched by default: