Skip to content

Configuration

paranarimasu edited this page Nov 29, 2022 · 38 revisions

Note: WIP. Please contact para in the Discord for corrections or missing information.


Here we will configure the application for our development environment.

This guide covers configurations that expose settings to the .env file. This guide does not provide an overview for all configuration files.

API

These properties pertain to how to interact with the AnimeThemes API.

API Domain

These properties represent the base URL that the API is hosted on.

API_URL

Set this value if the API should be hosted on a subdomain such as api.animethemes.test. Otherwise, leave this null.

API_PATH

Set this value if the API is hosted at the top-level domain such as animethemes.test/api. Otherwise, leave this null.

Feature Flags

These properties are the flags that toggle application features.

ALLOW_VIDEO_STREAMS

When video streams are allowed, requests to the video.show route will stream video. If disabled, requests to the video.show route will redirect the user to the welcome page.

If we do not have an access token to the video repository or own testing bucket, it is recommended to leave this value false. If set to true, we need to ensure that we have configured the needed properties for the videos disk in the config/filesystems.php file.

ALLOW_DISCORD_NOTIFICATIONS

When discord notifications are allowed, event listeners shall send discord notifications to the configured discord channel through the configured bot. If discord notifications are not allowed, event listeners shall not send discord notifications.

We may leave this as false if we do not want to dispatch discord notifications. If set to true, we need to ensure that we have configured the needed properties for the discord service in the config/services.php file AND the needed properties for our desired queue worker in config/queue.php to process the dispatched jobs to the configured service.

ALLOW_VIEW_RECORDING

When set to true, a view will be created for the viewable model in the show action of the resource controller. When set to false, a view will not be recorded. By default, this flag is set to false.

File: config/flags.php

Services

These properties store credentials for third party services such as Mailgun, Postmark, AWS and more. We should review this file if configuring external services.

MAL_BEARER_TOKEN

Bearer HTTP authentication scheme token used for MAL API calls. This is used solely for seeding purposes, and the seeder will be pruned from the project on the deployment of the wiki release, so we can leave this null.

If, for some reason, we need to use this seeder, this script can be used to generate an access token.

DO_BEARER_TOKEN

Bearer HTTP authentication scheme token used for hosting API calls. This is needed for the transparency page, but can be left null unless work is being done specifically for this page.

File: config/services.php