The Core SettingsStarted by Arceus at Apr 07, 2019 2:53 pm
Stand up child, and turn towards the lightning, and the thunder; so I can see what I've known for all these years.
The Core Settings
These settings should be fairly simple, but just in case, we'll go through them here, piece by piece, and I'll explain them in more detail. All the settings for your Gaia installation will be on the core settings page; there aren't that many, and keeping them all in one place means that it's very easy to find what you're looking for, when all you need to do is flip a silly switch.
These are all pretty simple:
- Site Name is what your Gaia site will be called. Due to reCAPTCHA not working at the moment, it currently also decides what the answer to the guest security anti-spam question is, and it is case-sensitive.
- Start Page determines what the default start module is. So, if you want your site's base URL (yoursite.com) to go directly to your forum index, you'll input just forum. It is relative, and currently doesn't work with custom pages, but it should by release.
- Admin Contact: this field can be filled in with the preferred method of contacting the root administrator on your site. It can be an email address, or a Discord tag, whatever you'd prefer. This is shown to guests that need to contact an admin.
- We're Open!: Flipping this switch to on causes your site to become "online." This logs the open date in your settings array, and, when Gaia is released, will enable registration without a special registration code.
The user settings section is simply put, controllers that decide what users can and cannot do on your site. It primarily exists just to turn certain features and functions off or on, depending on how you want your site to operate. There are:
- Allow Guest Browsing: All Gaia installations begin with this turned off, to prevent guest access before the site is ready for it. You can turn this off to allow guests to browse your site (otherwise it will always redirect to the login page), or leave it off to effectively have a private, members only site. It will eventually allow guests to register, if you have a registration code set up.
- Allow User Titles: You'll see <= over there I have something under my name, above my avatar. This is the user title. Enabling or disabling this function is global, meaning a certain group cannot have one anyway, and it also counts for characters.
- Allow User Quotes: You'll also see <= over there, below my age and post count, there's a bunch of words. This is a user quote. It's a very long bunch of words that users can input if they want, say, song lyrics, or a proverb, or something under their avatar. This is also global, and also counts for characters.
- Allow User Signatures: I'm going to just assume everyone knows what a signature is. Global, counts for characters.
- Enable Mature Content: What this does is enables users to mark their topics as containing mature content, and allow them to turn mature content on in their user profile. Without this switch flipped, all content will be available to all users that have access to the given board it is located in.
Timezone and Formatting
This section controls how timestamps are formatted and displayed on your site, and the default timezone that the Gaia site will use for it. Members can override the default timezone with their own in their profile controls, but cannot alter the formatting options.
- Default Timezone: It comes in America/Chicago by default.
- Order Day Before Month: This causes dates to become 07 April 2019 instead of April 07, 2019.
- Use Short Month Names: This causes dates to become Apr 07, 2019.
- Use 24 Hour Clock: This means your times will become 13:22 instead of 1:22 pm. This is often called "military time," as the military notoriously uses it.
- Uppercase AM/PM: This just makes the am/pm markers display uppercased (AM/PM instead).
This is the super fun part! You'll have to input maximum image sizes for avatars and images if you intend to use them (does not count for cover images or character gallery images), or the system will constantly reject them for file size. These functions are a super important part of how Gaia handles image processing.
- Allow Avatars: avatars, by default, are always a perfect square in size.
- Allow Secondary Images: If you want an extra image that is not a perfect square, you'll want to turn these on.
- Maximum Avatar Size/Maximum Image Width/Height: These are all size settings, in pixels, for the avatars and secondary images. Note that you should not input "px" or anything after the numbers, just the numbers.
- Allow Rotating Character Avatars/Images: Turning either of these on causes the related character image upload to allow multiple file selections. Each one will be stored as an avatar, or image, and one will be selected at random every time that image is asked for. You may even get different avatars/images in each post in a single thread, too.
This is the controller section for the reCAPTCHA integration. If you are not sure if your server will support reCAPTCHA, you can input the site and secret keys for your site URL provided by Google, and then test to see if it does work. It will override the default "what is our site name" security question. Many shared hosting server environments have fopen() disabled, meaning that Gaia cannot make sense of Google's response. I'm attempting to get it working with cURL instead, but my attempts so far have been unsuccessful. I have no idea if Gaia will ever be able to globally support reCAPTCHA.
In this section, you'll set up how your affiliation system works.
- Accepting Affiliates: Turn this switch on to allow guests and users on the front-end to apply for affiliation with your site.
- Affiliate Button Width/Height: Gaia will not accept affiliate buttons until these are set. Like with avatar and image sizes, these are pixel sizes, without the "px" part.
- Affiliation Rules: This is what is displayed to users applying for affiliation on the application screen, and in the affiliation section as a link. It ensures that interested users and guests have quick and easy access to your affiliation rules.
These settings turn certain functions of the character system on or off. Characters can be sorted into three levels of group: the alliance; the department; and the rank. Alliances are the top-level of colour-capable group, so if you only need one group, go with alliance. Departments are the next level of color-capable group, and can only be children of alliances, not standalone. Ranks are standalone, but do not affect character name colour, only have a badge image. Together, these three stages of grouping can create a very robust, fine-tuned grouping system. All three can be renamed to suit your site's usage.
- Enable Alliances: This will be called how you name them in the character labels system, but turning this on enables the first level of character group.
- Enable Departments: This will be called how you name them, and turning this on enables departments to be made.
- Enable Ranks: This will be called how you name them, and turning this on enables ranks to be made.
- Enable Non-Player Characters: Turn this switch on to allow users to create NPCs. NPCs are not listed with their creator's other characters, and, if enabled, can be posted with by any user, not just the one that made them. NPCs do not count toward a user's global character limit.
- Characters Must Be Approved: Turn this on to tell Gaia to wait for staff approval on a character's application/biography/sheet before allowing them to be used.
- Enable Character Journals: Turning this on allows users to create character "blogs," where they can post one-shots, NRNs, journal entries, whatever. How you use the journal system depends on how your site culture deems is best.
These are the little settings that alter how your character management system operates and displays certain things.
- Display Biography Sections as Tabs: Turning this on will cause bio form sections to become separate tabs, rather than headers. With it off, each section will be a header in the Profile section of the character's profile page. With it on, these sections become other tabs, useful if you have a large biography/sheet.
- Allow Free Character Group Changing: With this off, users cannot change their character's group and or rank after that character is activated and approved, and must click a button to get it filed into the admin panel's approval queue, where staff can deny or reject, or even change which group the character goes into. With it on, they can change their alliance, department, and rank, at any time without approval.
- Allow Non-Power Users to Post With Any NPC: This allows regular, non-staff members to post with any NPC, even if they did not create that NPC.
- Global Character Limit: There are three kinds of limit; the first is unlimited, and it ignores the limit value input beneath it no matter what. The second is hard cap. A hard cap actively prevents a user from creating more characters past the limit value number. The third is the soft cap. This will not actively block a user from creating more characters past the limit value count, but it will suggest they drop some characters if they'd like to make another character past the cap.
Rename alliances, departments, and ranks, here. The name is used globally across the Gaia system, however it is not terribly smart, and just sorta adds an 's' to the end and guesses what the plural form is.
And that's it! That's all there is to the core settings of Gaia. Painless, no? c: