Difference between revisions of "Config Files"

From Lorekeeper Wiki
Jump to navigation Jump to search
(Created page with " The configuration files are files in the site’s code that allow customisation of certain features that are highly unlikely to be changed on a regular basis. {| class="wiki...")
 
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
  
 +
The configuration files are files in the site’s code that allow customization of certain features that are highly unlikely to be changed on a regular basis.
 +
=Usage=
 +
These files are located in config/lorekeeper. The following files may be edited to configure an individual site:
  
The configuration files are files in the site’s code that allow customisation of certain features that are highly unlikely to be changed on a regular basis.
+
*settings.php
{| class="wikitable"
+
*extensions.php
|Fold
+
*sites.php
  
Table of Contents
+
The others should not be touched except when adding new features. A possible exception may be made for admin_sidebar.php in the event that you are rearranging the sidebar contents. However, please take care in this case to maintain syntax as well as sidebar items.
  
Usage
+
=Files=
  
Files
+
===settings.php===
 +
This file lists some basic site settings that are unlikely to change once the site is in use, and therefore should be modified before all else. The following properties can be modified here:
  
settings.php
+
*Site Name
 +
*Character Codes (formatting)
 +
*Masterlist Thumbnail Dimensions
 +
*Trade Asset Limit
  
admin_sidebar.php
+
Please refer to the comments in the file itself for a complete description of each setting.
 
 
image_files.php
 
 
 
item_tags.php
 
 
 
notifications.php
 
 
 
powers.php
 
 
 
text_pages.php
 
 
 
See Also
 
|}
 
 
 
= Usage =
 
These files are located in config/lorekeeper. The settings.php file is the only file that may require any editing at all; the others should not be touched except when coding new features.
 
  
= Files =
+
===extensions.php===
 +
This file lists settings to enable and disable as well as configure certain opt-in extensions integrated into Lorekeeper. For more information, see [[Updating: to 2.0.0]].
  
== settings.php ==
+
===sites.php===
This file lists some basic site settings that are unlikely to change once the site is in use, and therefore should be modified before all else. The following properties can be modified here:
+
This file lists various sites and values for them and is used to enable/disable available authentication options as well as assist with formatting. For more information, see [[Updating: to 2.0.0]].
  
* Site Name
+
=== group_currency_form.php ===
* Character Codes (formatting)
+
This file lists form fields and information for inclusion in the group currency form. For more information, see [[Galleries]].
* Masterlist Thumbnail Dimensions
 
* Trade Asset Limit
 
  
Please refer to the comments in the file itself for a complete description of each setting.
+
===extension_tracker.php===
 +
This file lists extensions installed on an individual Lorekeeper site and is used to supply information for the <code>php artisan update-extension-tracker</code> command. It should only be modified by extension authors. For more information, see [[Updating: to 2.0.0]].
  
== admin_sidebar.php ==
+
===admin_sidebar.php===
 
This file lists the links in the admin panel sidebar, as well as the staff power required to view the category of links.
 
This file lists the links in the admin panel sidebar, as well as the staff power required to view the category of links.
  
== image_files.php ==
+
===image_files.php===
 
This file lists the files that will appear in the image uploader section of the admin panel.
 
This file lists the files that will appear in the image uploader section of the admin panel.
  
== item_tags.php ==
+
===item_tags.php===
This file lists item tags that are available to attach to items. Please refer to (tutorial) for how to use this file.
+
This file lists item tags that are available to attach to items. Please refer to [[Tutorial: Creating Item Types]] for how to use this file.
  
== notifications.php ==
+
===notifications.php===
 
This file lists notification types as well as their message texts.
 
This file lists notification types as well as their message texts.
  
== powers.php ==
+
===powers.php===
 
This file lists staff powers that can be attached to user ranks.
 
This file lists staff powers that can be attached to user ranks.
  
== text_pages.php ==
+
===text_pages.php===
 
This file lists text pages that are generated during setup and cannot be deleted from the admin panel.
 
This file lists text pages that are generated during setup and cannot be deleted from the admin panel.
  
= See Also =
+
=See Also=
 +
 
 +
*Site Settings
  
* Site Settings
+
[[Category:Documentation]]

Latest revision as of 06:56, 24 July 2021

The configuration files are files in the site’s code that allow customization of certain features that are highly unlikely to be changed on a regular basis.

Usage

These files are located in config/lorekeeper. The following files may be edited to configure an individual site:

  • settings.php
  • extensions.php
  • sites.php

The others should not be touched except when adding new features. A possible exception may be made for admin_sidebar.php in the event that you are rearranging the sidebar contents. However, please take care in this case to maintain syntax as well as sidebar items.

Files

settings.php

This file lists some basic site settings that are unlikely to change once the site is in use, and therefore should be modified before all else. The following properties can be modified here:

  • Site Name
  • Character Codes (formatting)
  • Masterlist Thumbnail Dimensions
  • Trade Asset Limit

Please refer to the comments in the file itself for a complete description of each setting.

extensions.php

This file lists settings to enable and disable as well as configure certain opt-in extensions integrated into Lorekeeper. For more information, see Updating: to 2.0.0.

sites.php

This file lists various sites and values for them and is used to enable/disable available authentication options as well as assist with formatting. For more information, see Updating: to 2.0.0.

group_currency_form.php

This file lists form fields and information for inclusion in the group currency form. For more information, see Galleries.

extension_tracker.php

This file lists extensions installed on an individual Lorekeeper site and is used to supply information for the php artisan update-extension-tracker command. It should only be modified by extension authors. For more information, see Updating: to 2.0.0.

admin_sidebar.php

This file lists the links in the admin panel sidebar, as well as the staff power required to view the category of links.

image_files.php

This file lists the files that will appear in the image uploader section of the admin panel.

item_tags.php

This file lists item tags that are available to attach to items. Please refer to Tutorial: Creating Item Types for how to use this file.

notifications.php

This file lists notification types as well as their message texts.

powers.php

This file lists staff powers that can be attached to user ranks.

text_pages.php

This file lists text pages that are generated during setup and cannot be deleted from the admin panel.

See Also

  • Site Settings