'.\"\\n\";\n $toc .= ''.\"\\n\";\n\n return [$toc, $content];\n }\n\n /**\n * Safely extracts value from Statamic Value objects\n */\n private function valueGet($value)\n {\n if ($value instanceof \\Statamic\\Fields\\Value) {\n return $value->value();\n }\n\n return $value;\n }\n\n private function slugify($text)\n {\n $slugified = Statamic::modify($text)->replace('&', '')->slugify()->stripTags();\n // Remove 'code-code' from the slugified text e.g. Otherwise \"the `@` ignore symbol\" gets converted to `the-code-code-ignore-symbol`\n $slugified = str_replace('code-code-', '', $slugified);\n // Remove HTML entity remnants that might be left after processing\n // Only remove these if they appear as standalone words or at word boundaries\n $slugified = preg_replace('/\\b(codelt|rt|gtcode)\\b/', '', $slugified);\n\n return $slugified;\n }\n}\n"
},
{
"path": "app/Providers/AppServiceProvider.php",
"content": "runningConsoleCommand('search:update')) {\n TorchlightOptions::setDefaultOptionsBuilder(fn () => TorchlightOptions::fromArray(config('torchlight.options')));\n\n $extension = new TorchlightExtension(config('torchlight.theme'));\n $extension\n ->renderer()\n ->setDefaultGrammar(config('torchlight.options.defaultLanguage'));\n\n Markdown::addExtension(fn () => $extension);\n }\n\n Event::listen(SearchEntriesCreated::class, SearchEntriesCreatedListener::class);\n\n StorybookSearchProvider::register();\n }\n}\n"
},
{
"path": "app/Search/DocTransformer.php",
"content": "lower()\n ->explode(' ')\n ->map(fn ($word) => Str::singular($word))\n ->join(' ');\n }\n\n public function handle(DocumentFragment $fragment, $entry): void\n {\n $fragment->additionalContextData[] = $this->normalizeConent($entry->title);\n\n // Add some extra details to \"additional_context\"\n if (Str::containsAll($fragment->content, ['clear', 'cache'])) {\n $fragment->additionalContextData[] = 'delete cache';\n }\n\n if (Str::contains($fragment->content, 'JS Drivers')) {\n $fragment->additionalContextData[] = 'javascript drivers';\n }\n }\n}\n"
},
{
"path": "app/Search/Listeners/SearchEntriesCreatedListener.php",
"content": "level;\n\n for ($i = array_search($target, $headers) - 1; $i >= 0; $i--) {\n $header = $headers[$i];\n\n if ($header->level < $currentLevel) {\n $hierarchy[] = $header;\n $currentLevel = $header->level;\n }\n }\n\n foreach (array_reverse($hierarchy) as $level) {\n $levels[$level->level] = str($level->text)->replaceEnd('#', '')->__toString();\n }\n\n return $levels;\n }\n\n /**\n * Handle the event.\n */\n public function handle(SearchEntriesCreated $event): void\n {\n $collection = $event->entry->collection()->title;\n\n $headers = [];\n\n foreach ($event->sections as $section) {\n if ($section->fragment->headerDetails == null) {\n continue;\n }\n\n $headers[] = $section->fragment->headerDetails;\n }\n\n foreach ($event->sections as $section) {\n $data = $section->searchEntry->data();\n $data['search_title'] = str($data['search_title'] ?? '')->replaceEnd('#', '')->__toString();\n\n $category = match (true) {\n $collection === 'Pages' => ($event->entry->parent() ? $event->entry->parent()?->title.' » ' : null).$data['origin_title'],\n default => $collection.' » '.$data['origin_title'],\n };\n\n $parentHeadings = null;\n\n if (\n $section->fragment->headerDetails != null &&\n $section->fragment->headerDetails->level >= 3\n ) {\n $header = $section->fragment->headerDetails;\n\n $parentHeadings = $this->getParentHeadings(\n $headers,\n $header\n );\n $parentHeadings[$header->level] = $header->text;\n }\n\n if ($parentHeadings === null) {\n $parentHeadings = [];\n\n if ($data['search_title'] != null && $data['origin_title'] != $data['search_title']) {\n $parentHeadings[1] = $data['search_title'];\n }\n }\n\n if (count($parentHeadings) > 2) {\n array_shift($parentHeadings);\n }\n\n $data['hierarchy_lvl0'] = $category;\n $data['hierarchy_lvl1'] = str(implode(' » ', $parentHeadings))->replaceEnd('#', '')->__toString();\n\n if ($data['is_root']) {\n $data['content'] = strip_tags($event->entry->intro ?? $event->entry->description ?? $data['search_content']);\n } else {\n $data['content'] = $data['search_content'] ?? '';\n }\n\n $data['url'] = $data['search_url'];\n\n foreach ($this->escapeProperties as $property) {\n if (! $data->has($property)) {\n continue;\n }\n\n $data[$property] = e($data[$property]);\n }\n\n // Clear this out to prevent \"too much\" from a specific page dominating the results.\n if (! $data['is_root']) {\n $data['origin_title'] = null;\n }\n\n $section->searchEntry->data($data);\n }\n }\n}\n"
},
{
"path": "app/Search/RequestContentRetriever.php",
"content": "instance('request', $request);\n Cascade::withRequest($request);\n });\n\n $content = '';\n\n try {\n $content = $entry->toResponse($request)->getContent();\n } finally {\n app()->instance('request', $originalRequest);\n }\n\n return $this->extractArticleContent($content);\n }\n\n protected function extractArticleContent(string $content): string\n {\n $dom = new DOMDocument;\n\n libxml_use_internal_errors(true);\n $dom->loadHTML($content);\n libxml_clear_errors();\n\n $articles = $dom->getElementsByTagName('article');\n\n $result = '';\n\n foreach ($articles as $article) {\n $result .= $dom->saveHTML($article);\n }\n\n return $result;\n }\n}\n"
},
{
"path": "app/Search/Storybook/StorybookSearchProvider.php",
"content": "collect('entries')\n ->filter(fn (array $story) => Str::endsWith($story['id'], ['--docs', '--default']))\n ->unique('title')\n ->map(fn (array $story) => StorybookSearchable::from($story))\n ->map->reference();\n }\n\n public function contains($searchable): bool\n {\n // TODO: Implement contains() method.\n }\n\n public function find(array $keys): Collection\n {\n $stories = Http::get('https://ui.statamic.dev/index.json')->collect('entries');\n\n return collect($keys)->map(fn (string $key) => StorybookSearchable::from($stories->get($key)));\n }\n}"
},
{
"path": "app/Search/Storybook/StorybookSearchable.php",
"content": "id = $component['id'];\n $instance->title = Str::after($component['title'], '/');\n\n return $instance;\n }\n\n public function id(): string\n {\n return $this->id;\n }\n\n public function title(): string\n {\n return $this->title;\n }\n\n public function getSearchValue(string $field)\n {\n if ($field === 'title' || $field === 'origin_title' || $field === 'search_title') {\n return $this->title();\n }\n\n if ($field === 'hierarchy_lvl0') {\n return \"UI Components » {$this->title()}\";\n }\n\n if ($field === 'url') {\n return $this->url();\n }\n\n return null;\n }\n\n public function url(): string\n {\n return \"https://ui.statamic.dev/?path=/docs/{$this->id}\";\n }\n\n public function reference(): string\n {\n return \"storybook::{$this->id()}\";\n }\n}"
},
{
"path": "app/Tags/GithubCommitsUrl.php",
"content": "context->get('id')) {\n return false;\n }\n\n $content = Data::find($id);\n\n if ($content instanceof \\Statamic\\Taxonomies\\LocalizedTerm) {\n return;\n }\n\n $path = Str::after($content->path(), 'content/');\n\n return \"https://github.com/statamic/docs/commits/{$this->getCurrentBranch()}/content/{$path}\";\n }\n\n private function getCurrentBranch(): string\n {\n return collect(config('docs.versions'))\n ->where('version', config('docs.version'))\n ->first()['branch'] ?? '5.x';\n }\n}\n"
},
{
"path": "app/Tags/GithubEditUrl.php",
"content": "context->get('id')) {\n return false;\n }\n\n $content = Data::find($id);\n\n if ($content instanceof \\Statamic\\Taxonomies\\LocalizedTerm) {\n return;\n }\n\n $path = Str::after($path = $content->path(), 'content/');\n\n return \"https://github.com/statamic/docs/blob/{$this->getCurrentBranch()}/content/{$path}\";\n }\n\n private function getCurrentBranch(): string\n {\n return collect(config('docs.versions'))\n ->where('version', config('docs.version'))\n ->first()['branch'] ?? '5.x';\n }\n}\n"
},
{
"path": "app/Tags/HeroSponsors.php",
"content": "addHour(), function () {\n try {\n return $this->sponsors()->collect()->where('price', '>=', 25);\n } catch (\\Exception $e) {\n Log::error($e);\n\n return collect(['error' => true]);\n }\n });\n }\n\n private function sponsors()\n {\n return LazyCollection::make(function () {\n $cursor = null;\n\n do {\n $data = $this->request($cursor);\n $sponsorships = Arr::get($data, 'data.viewer.organization.sponsorshipsAsMaintainer');\n $cursor = $sponsorships['pageInfo']['endCursor'];\n $hasNextPage = $sponsorships['pageInfo']['hasNextPage'];\n\n yield from collect($sponsorships['nodes'])->map(fn ($sponsorship) => array_merge(\n $sponsorship['sponsorEntity'],\n ['price' => $sponsorship['tier']['monthlyPriceInDollars']]\n ));\n } while ($hasNextPage && $cursor);\n });\n }\n\n private function request($cursor)\n {\n return Http::baseUrl('https://api.github.com')\n ->withToken(config('services.github.token'))\n ->asJson()\n ->accept('application/vnd.github.v4+json')\n ->withUserAgent('statamic/docs')\n ->post('/graphql', [\n 'query' => $this->query(),\n 'variables' => ['cursor' => $cursor],\n ])\n ->json();\n }\n\n private function query()\n {\n return <<<'GQL'\nquery($cursor: String) {\n viewer {\n organization(login: \"statamic\") {\n sponsorshipsAsMaintainer(first: 100, after: $cursor, orderBy: {direction: ASC, field: CREATED_AT}) {\n pageInfo {\n hasNextPage\n endCursor\n }\n nodes {\n sponsorEntity {\n ... on User {\n name\n url\n avatarUrl(size: 80)\n }\n ... on Organization {\n name\n url\n avatarUrl(size: 80)\n }\n }\n tier {\n name\n monthlyPriceInDollars\n }\n }\n }\n }\n }\n}\nGQL;\n }\n}\n"
},
{
"path": "app/ViewModels/Fieldtypes.php",
"content": " ucwords($this->cascade->get('title')).' Fieldtype'];\n }\n}\n"
},
{
"path": "app/ViewModels/Modifiers.php",
"content": " ucwords($this->cascade->get('title')).' Modifier'];\n }\n}\n"
},
{
"path": "app/ViewModels/Tags.php",
"content": " ucwords($this->cascade->get('slug')).' Tag'];\n }\n}\n"
},
{
"path": "app/ViewModels/Variables.php",
"content": " strtolower($this->cascade->get('slug'))];\n }\n}\n"
},
{
"path": "artisan",
"content": "#!/usr/bin/env php\nhandleCommand(new ArgvInput);\n\nexit($status);\n"
},
{
"path": "bootstrap/app.php",
"content": "withRouting(\n web: __DIR__.'/../routes/web.php',\n commands: __DIR__.'/../routes/console.php',\n health: '/up',\n )\n ->withMiddleware(function (Middleware $middleware): void {\n //\n })\n ->withExceptions(function (Exceptions $exceptions): void {\n //\n })->create();\n"
},
{
"path": "bootstrap/cache/.gitignore",
"content": "*\n!.gitignore\n"
},
{
"path": "bootstrap/providers.php",
"content": " env('APP_NAME', 'Statamic'),\n\n /*\n |--------------------------------------------------------------------------\n | Application Environment\n |--------------------------------------------------------------------------\n |\n | This value determines the \"environment\" your application is currently\n | running in. This may determine how you prefer to configure various\n | services the application utilizes. Set this in your \".env\" file.\n |\n */\n\n 'env' => env('APP_ENV', 'production'),\n\n /*\n |--------------------------------------------------------------------------\n | Application Debug Mode\n |--------------------------------------------------------------------------\n |\n | When your application is in debug mode, detailed error messages with\n | stack traces will be shown on every error that occurs within your\n | application. If disabled, a simple generic error page is shown.\n |\n */\n\n 'debug' => (bool) env('APP_DEBUG', false),\n\n /*\n |--------------------------------------------------------------------------\n | Application URL\n |--------------------------------------------------------------------------\n |\n | This URL is used by the console to properly generate URLs when using\n | the Artisan command line tool. You should set this to the root of\n | the application so that it's available within Artisan commands.\n |\n */\n\n 'url' => env('APP_URL', 'http://localhost'),\n\n /*\n |--------------------------------------------------------------------------\n | Application Timezone\n |--------------------------------------------------------------------------\n |\n | Here you may specify the default timezone for your application, which\n | will be used by the PHP date and date-time functions. The timezone\n | is set to \"UTC\" by default as it is suitable for most use cases.\n |\n */\n\n 'timezone' => 'UTC',\n\n /*\n |--------------------------------------------------------------------------\n | Application Locale Configuration\n |--------------------------------------------------------------------------\n |\n | The application locale determines the default locale that will be used\n | by Laravel's translation / localization methods. This option can be\n | set to any locale for which you plan to have translation strings.\n |\n */\n\n 'locale' => env('APP_LOCALE', 'en'),\n\n 'fallback_locale' => env('APP_FALLBACK_LOCALE', 'en'),\n\n 'faker_locale' => env('APP_FAKER_LOCALE', 'en_US'),\n\n /*\n |--------------------------------------------------------------------------\n | Encryption Key\n |--------------------------------------------------------------------------\n |\n | This key is utilized by Laravel's encryption services and should be set\n | to a random, 32 character string to ensure that all encrypted values\n | are secure. You should do this prior to deploying the application.\n |\n */\n\n 'cipher' => 'AES-256-CBC',\n\n 'key' => env('APP_KEY'),\n\n 'previous_keys' => [\n ...array_filter(\n explode(',', (string) env('APP_PREVIOUS_KEYS', ''))\n ),\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Maintenance Mode Driver\n |--------------------------------------------------------------------------\n |\n | These configuration options determine the driver used to determine and\n | manage Laravel's \"maintenance mode\" status. The \"cache\" driver will\n | allow maintenance mode to be controlled across multiple machines.\n |\n | Supported drivers: \"file\", \"cache\"\n |\n */\n\n 'maintenance' => [\n 'driver' => env('APP_MAINTENANCE_DRIVER', 'file'),\n 'store' => env('APP_MAINTENANCE_STORE', 'file'),\n ],\n\n];\n"
},
{
"path": "config/auth.php",
"content": " [\n 'guard' => env('AUTH_GUARD', 'web'),\n 'passwords' => env('AUTH_PASSWORD_BROKER', 'users'),\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Authentication Guards\n |--------------------------------------------------------------------------\n |\n | Next, you may define every authentication guard for your application.\n | Of course, a great default configuration has been defined for you\n | which utilizes session storage plus the Eloquent user provider.\n |\n | All authentication guards have a user provider, which defines how the\n | users are actually retrieved out of your database or other storage\n | system used by the application. Typically, Eloquent is utilized.\n |\n | Supported: \"session\"\n |\n */\n\n 'guards' => [\n 'web' => [\n 'driver' => 'session',\n 'provider' => 'users',\n ],\n ],\n\n /*\n |--------------------------------------------------------------------------\n | User Providers\n |--------------------------------------------------------------------------\n |\n | All authentication guards have a user provider, which defines how the\n | users are actually retrieved out of your database or other storage\n | system used by the application. Typically, Eloquent is utilized.\n |\n | If you have multiple user tables or models you may configure multiple\n | providers to represent the model / table. These providers may then\n | be assigned to any extra authentication guards you have defined.\n |\n | Supported: \"statamic\", \"database\", \"eloquent\"\n |\n */\n\n 'providers' => [\n 'users' => [\n 'driver' => 'statamic',\n ],\n\n // 'users' => [\n // 'driver' => 'eloquent',\n // 'model' => env('AUTH_MODEL', User::class),\n // ],\n\n // 'users' => [\n // 'driver' => 'database',\n // 'table' => 'users',\n // ],\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Resetting Passwords\n |--------------------------------------------------------------------------\n |\n | These configuration options specify the behavior of Laravel's password\n | reset functionality, including the table utilized for token storage\n | and the user provider that is invoked to actually retrieve users.\n |\n | The expiry time is the number of minutes that each reset token will be\n | considered valid. This security feature keeps tokens short-lived so\n | they have less time to be guessed. You may change this as needed.\n |\n | The throttle setting is the number of seconds a user must wait before\n | generating more password reset tokens. This prevents the user from\n | quickly generating a very large amount of password reset tokens.\n |\n */\n\n 'passwords' => [\n 'users' => [\n 'provider' => 'users',\n 'table' => env('AUTH_PASSWORD_RESET_TOKEN_TABLE', 'password_reset_tokens'),\n 'expire' => 60,\n 'throttle' => 60,\n ],\n\n 'activations' => [\n 'provider' => 'users',\n 'table' => env('AUTH_ACTIVATION_TOKEN_TABLE', 'password_activation_tokens'),\n 'expire' => 4320,\n 'throttle' => 60,\n ],\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Password Confirmation Timeout\n |--------------------------------------------------------------------------\n |\n | Here you may define the number of seconds before a password confirmation\n | window expires and users are asked to re-enter their password via the\n | confirmation screen. By default, the timeout lasts for three hours.\n |\n */\n\n 'password_timeout' => env('AUTH_PASSWORD_TIMEOUT', 10800),\n\n];\n"
},
{
"path": "config/cache.php",
"content": " env('CACHE_STORE', 'file'),\n\n /*\n |--------------------------------------------------------------------------\n | Cache Stores\n |--------------------------------------------------------------------------\n |\n | Here you may define all of the cache \"stores\" for your application as\n | well as their drivers. You may even define multiple stores for the\n | same cache driver to group types of items stored in your caches.\n |\n | Supported drivers: \"array\", \"database\", \"file\", \"memcached\",\n | \"redis\", \"dynamodb\", \"octane\",\n | \"failover\", \"null\"\n |\n */\n\n 'stores' => [\n\n 'array' => [\n 'driver' => 'array',\n 'serialize' => false,\n ],\n\n 'database' => [\n 'driver' => 'database',\n 'connection' => env('DB_CACHE_CONNECTION', null),\n 'table' => env('DB_CACHE_TABLE', 'cache'),\n 'lock_connection' => env('DB_CACHE_LOCK_CONNECTION'),\n 'lock_table' => env('DB_CACHE_LOCK_TABLE'),\n ],\n\n 'file' => [\n 'driver' => 'file',\n 'path' => storage_path('framework/cache/data'),\n 'lock_path' => storage_path('framework/cache/data'),\n ],\n\n 'memcached' => [\n 'driver' => 'memcached',\n 'persistent_id' => env('MEMCACHED_PERSISTENT_ID'),\n 'sasl' => [\n env('MEMCACHED_USERNAME'),\n env('MEMCACHED_PASSWORD'),\n ],\n 'options' => [\n // Memcached::OPT_CONNECT_TIMEOUT => 2000,\n ],\n 'servers' => [\n [\n 'host' => env('MEMCACHED_HOST', '127.0.0.1'),\n 'port' => env('MEMCACHED_PORT', 11211),\n 'weight' => 100,\n ],\n ],\n ],\n\n 'redis' => [\n 'driver' => 'redis',\n 'connection' => env('REDIS_CACHE_CONNECTION', 'cache'),\n 'lock_connection' => env('REDIS_CACHE_LOCK_CONNECTION', 'default'),\n ],\n\n 'dynamodb' => [\n 'driver' => 'dynamodb',\n 'key' => env('AWS_ACCESS_KEY_ID'),\n 'secret' => env('AWS_SECRET_ACCESS_KEY'),\n 'region' => env('AWS_DEFAULT_REGION', 'us-east-1'),\n 'table' => env('DYNAMODB_CACHE_TABLE', 'cache'),\n 'endpoint' => env('DYNAMODB_ENDPOINT'),\n ],\n\n 'octane' => [\n 'driver' => 'octane',\n ],\n\n 'failover' => [\n 'driver' => 'failover',\n 'stores' => [\n 'database',\n 'array',\n ],\n ],\n\n 'static_cache' => [\n 'driver' => 'file',\n 'path' => storage_path('statamic/static-urls-cache'),\n ],\n\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Cache Key Prefix\n |--------------------------------------------------------------------------\n |\n | When utilizing the APC, database, memcached, Redis, and DynamoDB cache\n | stores, there might be other applications using the same cache. For\n | that reason, you may prefix every cache key to avoid collisions.\n |\n */\n\n 'prefix' => env('CACHE_PREFIX', Str::slug((string) env('APP_NAME', 'laravel')).'-cache-'),\n\n /*\n |--------------------------------------------------------------------------\n | Serializable Classes\n |--------------------------------------------------------------------------\n |\n | This value determines the classes that can be unserialized from cache\n | storage. By default, no PHP classes will be unserialized from your\n | cache to prevent gadget chain attacks if your APP_KEY is leaked.\n |\n */\n\n 'serializable_classes' => false,\n\n];\n"
},
{
"path": "config/database.php",
"content": " env('DB_CONNECTION', 'sqlite'),\n\n /*\n |--------------------------------------------------------------------------\n | Database Connections\n |--------------------------------------------------------------------------\n |\n | Below are all of the database connections defined for your application.\n | An example configuration is provided for each database system which\n | is supported by Laravel. You're free to add / remove connections.\n |\n */\n\n 'connections' => [\n\n 'sqlite' => [\n 'driver' => 'sqlite',\n 'url' => env('DB_URL'),\n 'database' => env('DB_DATABASE', database_path('database.sqlite')),\n 'prefix' => '',\n 'foreign_key_constraints' => env('DB_FOREIGN_KEYS', true),\n 'busy_timeout' => null,\n 'journal_mode' => null,\n 'synchronous' => null,\n 'transaction_mode' => 'DEFERRED',\n ],\n\n 'mysql' => [\n 'driver' => 'mysql',\n 'url' => env('DB_URL'),\n 'host' => env('DB_HOST', '127.0.0.1'),\n 'port' => env('DB_PORT', '3306'),\n 'database' => env('DB_DATABASE', 'laravel'),\n 'username' => env('DB_USERNAME', 'root'),\n 'password' => env('DB_PASSWORD', ''),\n 'unix_socket' => env('DB_SOCKET', ''),\n 'charset' => env('DB_CHARSET', 'utf8mb4'),\n 'collation' => env('DB_COLLATION', 'utf8mb4_unicode_ci'),\n 'prefix' => '',\n 'prefix_indexes' => true,\n 'strict' => true,\n 'engine' => null,\n 'options' => extension_loaded('pdo_mysql') ? array_filter([\n (PHP_VERSION_ID >= 80500 ? Mysql::ATTR_SSL_CA : PDO::MYSQL_ATTR_SSL_CA) => env('MYSQL_ATTR_SSL_CA'),\n ]) : [],\n ],\n\n 'mariadb' => [\n 'driver' => 'mariadb',\n 'url' => env('DB_URL'),\n 'host' => env('DB_HOST', '127.0.0.1'),\n 'port' => env('DB_PORT', '3306'),\n 'database' => env('DB_DATABASE', 'laravel'),\n 'username' => env('DB_USERNAME', 'root'),\n 'password' => env('DB_PASSWORD', ''),\n 'unix_socket' => env('DB_SOCKET', ''),\n 'charset' => env('DB_CHARSET', 'utf8mb4'),\n 'collation' => env('DB_COLLATION', 'utf8mb4_unicode_ci'),\n 'prefix' => '',\n 'prefix_indexes' => true,\n 'strict' => true,\n 'engine' => null,\n 'options' => extension_loaded('pdo_mysql') ? array_filter([\n (PHP_VERSION_ID >= 80500 ? Mysql::ATTR_SSL_CA : PDO::MYSQL_ATTR_SSL_CA) => env('MYSQL_ATTR_SSL_CA'),\n ]) : [],\n ],\n\n 'pgsql' => [\n 'driver' => 'pgsql',\n 'url' => env('DB_URL'),\n 'host' => env('DB_HOST', '127.0.0.1'),\n 'port' => env('DB_PORT', '5432'),\n 'database' => env('DB_DATABASE', 'laravel'),\n 'username' => env('DB_USERNAME', 'root'),\n 'password' => env('DB_PASSWORD', ''),\n 'charset' => env('DB_CHARSET', 'utf8'),\n 'prefix' => '',\n 'prefix_indexes' => true,\n 'search_path' => 'public',\n 'sslmode' => env('DB_SSLMODE', 'prefer'),\n ],\n\n 'sqlsrv' => [\n 'driver' => 'sqlsrv',\n 'url' => env('DB_URL'),\n 'host' => env('DB_HOST', 'localhost'),\n 'port' => env('DB_PORT', '1433'),\n 'database' => env('DB_DATABASE', 'laravel'),\n 'username' => env('DB_USERNAME', 'root'),\n 'password' => env('DB_PASSWORD', ''),\n 'charset' => env('DB_CHARSET', 'utf8'),\n 'prefix' => '',\n 'prefix_indexes' => true,\n // 'encrypt' => env('DB_ENCRYPT', 'yes'),\n // 'trust_server_certificate' => env('DB_TRUST_SERVER_CERTIFICATE', 'false'),\n ],\n\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Migration Repository Table\n |--------------------------------------------------------------------------\n |\n | This table keeps track of all the migrations that have already run for\n | your application. Using this information, we can determine which of\n | the migrations on disk haven't actually been run on the database.\n |\n */\n\n 'migrations' => [\n 'table' => 'migrations',\n 'update_date_on_publish' => true,\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Redis Databases\n |--------------------------------------------------------------------------\n |\n | Redis is an open source, fast, and advanced key-value store that also\n | provides a richer body of commands than a typical key-value system\n | such as Memcached. You may define your connection settings here.\n |\n */\n\n 'redis' => [\n\n 'client' => env('REDIS_CLIENT', 'phpredis'),\n\n 'options' => [\n 'cluster' => env('REDIS_CLUSTER', 'redis'),\n 'prefix' => env('REDIS_PREFIX', Str::slug((string) env('APP_NAME', 'laravel')).'-database-'),\n 'persistent' => env('REDIS_PERSISTENT', false),\n ],\n\n 'default' => [\n 'url' => env('REDIS_URL'),\n 'host' => env('REDIS_HOST', '127.0.0.1'),\n 'username' => env('REDIS_USERNAME'),\n 'password' => env('REDIS_PASSWORD'),\n 'port' => env('REDIS_PORT', '6379'),\n 'database' => env('REDIS_DB', '0'),\n 'max_retries' => env('REDIS_MAX_RETRIES', 3),\n 'backoff_algorithm' => env('REDIS_BACKOFF_ALGORITHM', 'decorrelated_jitter'),\n 'backoff_base' => env('REDIS_BACKOFF_BASE', 100),\n 'backoff_cap' => env('REDIS_BACKOFF_CAP', 1000),\n ],\n\n 'cache' => [\n 'url' => env('REDIS_URL'),\n 'host' => env('REDIS_HOST', '127.0.0.1'),\n 'username' => env('REDIS_USERNAME'),\n 'password' => env('REDIS_PASSWORD'),\n 'port' => env('REDIS_PORT', '6379'),\n 'database' => env('REDIS_CACHE_DB', '1'),\n 'max_retries' => env('REDIS_MAX_RETRIES', 3),\n 'backoff_algorithm' => env('REDIS_BACKOFF_ALGORITHM', 'decorrelated_jitter'),\n 'backoff_base' => env('REDIS_BACKOFF_BASE', 100),\n 'backoff_cap' => env('REDIS_BACKOFF_CAP', 1000),\n ],\n\n ],\n\n];\n"
},
{
"path": "config/docs.php",
"content": " env('STATAMIC_DOCS_VERSION', '6'),\n\n 'versions' => [\n [\n 'version' => '6',\n 'branch' => '6.x',\n 'url' => 'https://statamic.dev',\n ],\n [\n 'version' => '5',\n 'branch' => '5.x',\n 'url' => 'https://v5.statamic.dev',\n ],\n ],\n\n];\n"
},
{
"path": "config/filesystems.php",
"content": " env('FILESYSTEM_DISK', 'local'),\n\n /*\n |--------------------------------------------------------------------------\n | Filesystem Disks\n |--------------------------------------------------------------------------\n |\n | Below you may configure as many filesystem disks as necessary, and you\n | may even configure multiple disks for the same driver. Examples for\n | most supported storage drivers are configured here for reference.\n |\n | Supported drivers: \"local\", \"ftp\", \"sftp\", \"s3\"\n |\n */\n\n 'disks' => [\n\n 'local' => [\n 'driver' => 'local',\n 'root' => storage_path('app/private'),\n 'serve' => true,\n 'throw' => false,\n 'report' => false,\n ],\n\n 'public' => [\n 'driver' => 'local',\n 'root' => storage_path('app/public'),\n 'url' => rtrim(env('APP_URL', 'http://localhost'), '/').'/storage',\n 'visibility' => 'public',\n 'throw' => false,\n 'report' => false,\n ],\n\n 's3' => [\n 'driver' => 's3',\n 'key' => env('AWS_ACCESS_KEY_ID'),\n 'secret' => env('AWS_SECRET_ACCESS_KEY'),\n 'region' => env('AWS_DEFAULT_REGION'),\n 'bucket' => env('AWS_BUCKET'),\n 'url' => env('AWS_URL'),\n 'endpoint' => env('AWS_ENDPOINT'),\n 'use_path_style_endpoint' => env('AWS_USE_PATH_STYLE_ENDPOINT', false),\n 'throw' => false,\n 'report' => false,\n // 'visibility' => 'public', // https://statamic.dev/assets#container-visibility\n ],\n\n 'assets' => [\n 'driver' => 'local',\n 'root' => public_path('img'),\n 'url' => '/img',\n 'visibility' => 'public',\n 'throw' => false,\n 'report' => false,\n ],\n\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Symbolic Links\n |--------------------------------------------------------------------------\n |\n | Here you may configure the symbolic links that will be created when the\n | `storage:link` Artisan command is executed. The array keys should be\n | the locations of the links and the values should be their targets.\n |\n */\n\n 'links' => [\n public_path('storage') => storage_path('app/public'),\n ],\n\n];\n"
},
{
"path": "config/logging.php",
"content": " env('LOG_CHANNEL', 'stack'),\n\n /*\n |--------------------------------------------------------------------------\n | Deprecations Log Channel\n |--------------------------------------------------------------------------\n |\n | This option controls the log channel that should be used to log warnings\n | regarding deprecated PHP and library features. This allows you to get\n | your application ready for upcoming major versions of dependencies.\n |\n */\n\n 'deprecations' => [\n 'channel' => env('LOG_DEPRECATIONS_CHANNEL', 'null'),\n 'trace' => env('LOG_DEPRECATIONS_TRACE', false),\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Log Channels\n |--------------------------------------------------------------------------\n |\n | Here you may configure the log channels for your application. Laravel\n | utilizes the Monolog PHP logging library, which includes a variety\n | of powerful log handlers and formatters that you're free to use.\n |\n | Available drivers: \"single\", \"daily\", \"slack\", \"syslog\",\n | \"errorlog\", \"monolog\", \"custom\", \"stack\"\n |\n */\n\n 'channels' => [\n\n 'stack' => [\n 'driver' => 'stack',\n 'channels' => explode(',', (string) env('LOG_STACK', 'single')),\n 'ignore_exceptions' => false,\n ],\n\n 'single' => [\n 'driver' => 'single',\n 'path' => storage_path('logs/laravel.log'),\n 'level' => env('LOG_LEVEL', 'debug'),\n 'replace_placeholders' => true,\n ],\n\n 'daily' => [\n 'driver' => 'daily',\n 'path' => storage_path('logs/laravel.log'),\n 'level' => env('LOG_LEVEL', 'debug'),\n 'days' => env('LOG_DAILY_DAYS', 14),\n 'replace_placeholders' => true,\n ],\n\n 'slack' => [\n 'driver' => 'slack',\n 'url' => env('LOG_SLACK_WEBHOOK_URL'),\n 'username' => env('LOG_SLACK_USERNAME', env('APP_NAME', 'Laravel')),\n 'emoji' => env('LOG_SLACK_EMOJI', ':boom:'),\n 'level' => env('LOG_LEVEL', 'critical'),\n 'replace_placeholders' => true,\n ],\n\n 'papertrail' => [\n 'driver' => 'monolog',\n 'level' => env('LOG_LEVEL', 'debug'),\n 'handler' => env('LOG_PAPERTRAIL_HANDLER', SyslogUdpHandler::class),\n 'handler_with' => [\n 'host' => env('PAPERTRAIL_URL'),\n 'port' => env('PAPERTRAIL_PORT'),\n 'connectionString' => 'tls://'.env('PAPERTRAIL_URL').':'.env('PAPERTRAIL_PORT'),\n ],\n 'processors' => [PsrLogMessageProcessor::class],\n ],\n\n 'stderr' => [\n 'driver' => 'monolog',\n 'level' => env('LOG_LEVEL', 'debug'),\n 'handler' => StreamHandler::class,\n 'handler_with' => [\n 'stream' => 'php://stderr',\n ],\n 'formatter' => env('LOG_STDERR_FORMATTER'),\n 'processors' => [PsrLogMessageProcessor::class],\n ],\n\n 'syslog' => [\n 'driver' => 'syslog',\n 'level' => env('LOG_LEVEL', 'debug'),\n 'facility' => env('LOG_SYSLOG_FACILITY', LOG_USER),\n 'replace_placeholders' => true,\n ],\n\n 'errorlog' => [\n 'driver' => 'errorlog',\n 'level' => env('LOG_LEVEL', 'debug'),\n 'replace_placeholders' => true,\n ],\n\n 'null' => [\n 'driver' => 'monolog',\n 'handler' => NullHandler::class,\n ],\n\n 'emergency' => [\n 'path' => storage_path('logs/laravel.log'),\n ],\n\n ],\n\n];\n"
},
{
"path": "config/mail.php",
"content": " env('MAIL_MAILER', 'log'),\n\n /*\n |--------------------------------------------------------------------------\n | Mailer Configurations\n |--------------------------------------------------------------------------\n |\n | Here you may configure all of the mailers used by your application plus\n | their respective settings. Several examples have been configured for\n | you and you are free to add your own as your application requires.\n |\n | Laravel supports a variety of mail \"transport\" drivers that can be used\n | when delivering an email. You may specify which one you're using for\n | your mailers below. You may also add additional mailers if needed.\n |\n | Supported: \"smtp\", \"sendmail\", \"mailgun\", \"ses\", \"ses-v2\",\n | \"postmark\", \"resend\", \"log\", \"array\",\n | \"failover\", \"roundrobin\"\n |\n */\n\n 'mailers' => [\n\n 'smtp' => [\n 'transport' => 'smtp',\n 'scheme' => env('MAIL_SCHEME'),\n 'url' => env('MAIL_URL'),\n 'host' => env('MAIL_HOST', '127.0.0.1'),\n 'port' => env('MAIL_PORT', 2525),\n 'username' => env('MAIL_USERNAME'),\n 'password' => env('MAIL_PASSWORD'),\n 'timeout' => null,\n 'local_domain' => env('MAIL_EHLO_DOMAIN', parse_url((string) env('APP_URL', 'http://localhost'), PHP_URL_HOST)),\n ],\n\n 'ses' => [\n 'transport' => 'ses',\n ],\n\n 'postmark' => [\n 'transport' => 'postmark',\n // 'message_stream_id' => env('POSTMARK_MESSAGE_STREAM_ID'),\n // 'client' => [\n // 'timeout' => 5,\n // ],\n ],\n\n 'resend' => [\n 'transport' => 'resend',\n ],\n\n 'sendmail' => [\n 'transport' => 'sendmail',\n 'path' => env('MAIL_SENDMAIL_PATH', '/usr/sbin/sendmail -bs -i'),\n ],\n\n 'log' => [\n 'transport' => 'log',\n 'channel' => env('MAIL_LOG_CHANNEL'),\n ],\n\n 'array' => [\n 'transport' => 'array',\n ],\n\n 'failover' => [\n 'transport' => 'failover',\n 'mailers' => [\n 'smtp',\n 'log',\n ],\n 'retry_after' => 60,\n ],\n\n 'roundrobin' => [\n 'transport' => 'roundrobin',\n 'mailers' => [\n 'ses',\n 'postmark',\n ],\n 'retry_after' => 60,\n ],\n\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Global \"From\" Address\n |--------------------------------------------------------------------------\n |\n | You may wish for all emails sent by your application to be sent from\n | the same address. Here you may specify a name and address that is\n | used globally for all emails that are sent by your application.\n |\n */\n\n 'from' => [\n 'address' => env('MAIL_FROM_ADDRESS', 'hello@example.com'),\n 'name' => env('MAIL_FROM_NAME', env('APP_NAME', 'Laravel')),\n ],\n\n];\n"
},
{
"path": "config/queue.php",
"content": " env('QUEUE_CONNECTION', 'sync'),\n\n /*\n |--------------------------------------------------------------------------\n | Queue Connections\n |--------------------------------------------------------------------------\n |\n | Here you may configure the connection options for every queue backend\n | used by your application. An example configuration is provided for\n | each backend supported by Laravel. You're also free to add more.\n |\n | Drivers: \"sync\", \"database\", \"beanstalkd\", \"sqs\", \"redis\",\n | \"deferred\", \"background\", \"failover\", \"null\"\n |\n */\n\n 'connections' => [\n\n 'sync' => [\n 'driver' => 'sync',\n ],\n\n 'database' => [\n 'driver' => 'database',\n 'connection' => env('DB_QUEUE_CONNECTION'),\n 'table' => env('DB_QUEUE_TABLE', 'jobs'),\n 'queue' => env('DB_QUEUE', 'default'),\n 'retry_after' => (int) env('DB_QUEUE_RETRY_AFTER', 90),\n 'after_commit' => false,\n ],\n\n 'beanstalkd' => [\n 'driver' => 'beanstalkd',\n 'host' => env('BEANSTALKD_QUEUE_HOST', 'localhost'),\n 'queue' => env('BEANSTALKD_QUEUE', 'default'),\n 'retry_after' => (int) env('BEANSTALKD_QUEUE_RETRY_AFTER', 90),\n 'block_for' => 0,\n 'after_commit' => false,\n ],\n\n 'sqs' => [\n 'driver' => 'sqs',\n 'key' => env('AWS_ACCESS_KEY_ID'),\n 'secret' => env('AWS_SECRET_ACCESS_KEY'),\n 'prefix' => env('SQS_PREFIX', 'https://sqs.us-east-1.amazonaws.com/your-account-id'),\n 'queue' => env('SQS_QUEUE', 'default'),\n 'suffix' => env('SQS_SUFFIX'),\n 'region' => env('AWS_DEFAULT_REGION', 'us-east-1'),\n 'after_commit' => false,\n ],\n\n 'redis' => [\n 'driver' => 'redis',\n 'connection' => env('REDIS_QUEUE_CONNECTION', 'default'),\n 'queue' => env('REDIS_QUEUE', 'default'),\n 'retry_after' => (int) env('REDIS_QUEUE_RETRY_AFTER', 90),\n 'block_for' => null,\n 'after_commit' => false,\n ],\n\n 'deferred' => [\n 'driver' => 'deferred',\n ],\n\n 'background' => [\n 'driver' => 'background',\n ],\n\n 'failover' => [\n 'driver' => 'failover',\n 'connections' => [\n 'database',\n 'deferred',\n ],\n ],\n\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Job Batching\n |--------------------------------------------------------------------------\n |\n | The following options configure the database and table that store job\n | batching information. These options can be updated to any database\n | connection and table which has been defined by your application.\n |\n */\n\n 'batching' => [\n 'database' => env('DB_CONNECTION', 'sqlite'),\n 'table' => 'job_batches',\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Failed Queue Jobs\n |--------------------------------------------------------------------------\n |\n | These options configure the behavior of failed queue job logging so you\n | can control how and where failed jobs are stored. Laravel ships with\n | support for storing failed jobs in a simple file or in a database.\n |\n | Supported drivers: \"database-uuids\", \"dynamodb\", \"file\", \"null\"\n |\n */\n\n 'failed' => [\n 'driver' => env('QUEUE_FAILED_DRIVER', 'database-uuids'),\n 'database' => env('DB_CONNECTION', 'sqlite'),\n 'table' => 'failed_jobs',\n ],\n\n];\n"
},
{
"path": "config/services.php",
"content": " [\n 'key' => env('POSTMARK_API_KEY'),\n ],\n\n 'resend' => [\n 'key' => env('RESEND_API_KEY'),\n ],\n\n 'ses' => [\n 'key' => env('AWS_ACCESS_KEY_ID'),\n 'secret' => env('AWS_SECRET_ACCESS_KEY'),\n 'region' => env('AWS_DEFAULT_REGION', 'us-east-1'),\n ],\n\n 'slack' => [\n 'notifications' => [\n 'bot_user_oauth_token' => env('SLACK_BOT_USER_OAUTH_TOKEN'),\n 'channel' => env('SLACK_BOT_USER_DEFAULT_CHANNEL'),\n ],\n ],\n\n 'github' => [\n 'token' => env('GITHUB_TOKEN'),\n ],\n\n];\n"
},
{
"path": "config/session.php",
"content": " env('SESSION_DRIVER', 'file'),\n\n /*\n |--------------------------------------------------------------------------\n | Session Lifetime\n |--------------------------------------------------------------------------\n |\n | Here you may specify the number of minutes that you wish the session\n | to be allowed to remain idle before it expires. If you want them\n | to expire immediately when the browser is closed then you may\n | indicate that via the expire_on_close configuration option.\n |\n */\n\n 'lifetime' => (int) env('SESSION_LIFETIME', 120),\n\n 'expire_on_close' => env('SESSION_EXPIRE_ON_CLOSE', false),\n\n /*\n |--------------------------------------------------------------------------\n | Session Encryption\n |--------------------------------------------------------------------------\n |\n | This option allows you to easily specify that all of your session data\n | should be encrypted before it's stored. All encryption is performed\n | automatically by Laravel and you may use the session like normal.\n |\n */\n\n 'encrypt' => env('SESSION_ENCRYPT', false),\n\n /*\n |--------------------------------------------------------------------------\n | Session File Location\n |--------------------------------------------------------------------------\n |\n | When utilizing the \"file\" session driver, the session files are placed\n | on disk. The default storage location is defined here; however, you\n | are free to provide another location where they should be stored.\n |\n */\n\n 'files' => storage_path('framework/sessions'),\n\n /*\n |--------------------------------------------------------------------------\n | Session Database Connection\n |--------------------------------------------------------------------------\n |\n | When using the \"database\" or \"redis\" session drivers, you may specify a\n | connection that should be used to manage these sessions. This should\n | correspond to a connection in your database configuration options.\n |\n */\n\n 'connection' => env('SESSION_CONNECTION'),\n\n /*\n |--------------------------------------------------------------------------\n | Session Database Table\n |--------------------------------------------------------------------------\n |\n | When using the \"database\" session driver, you may specify the table to\n | be used to store sessions. Of course, a sensible default is defined\n | for you; however, you're welcome to change this to another table.\n |\n */\n\n 'table' => env('SESSION_TABLE', 'sessions'),\n\n /*\n |--------------------------------------------------------------------------\n | Session Cache Store\n |--------------------------------------------------------------------------\n |\n | When using one of the framework's cache driven session backends, you may\n | define the cache store which should be used to store the session data\n | between requests. This must match one of your defined cache stores.\n |\n | Affects: \"dynamodb\", \"memcached\", \"redis\"\n |\n */\n\n 'store' => env('SESSION_STORE'),\n\n /*\n |--------------------------------------------------------------------------\n | Session Sweeping Lottery\n |--------------------------------------------------------------------------\n |\n | Some session drivers must manually sweep their storage location to get\n | rid of old sessions from storage. Here are the chances that it will\n | happen on a given request. By default, the odds are 2 out of 100.\n |\n */\n\n 'lottery' => [2, 100],\n\n /*\n |--------------------------------------------------------------------------\n | Session Cookie Name\n |--------------------------------------------------------------------------\n |\n | Here you may change the name of the session cookie that is created by\n | the framework. Typically, you should not need to change this value\n | since doing so does not grant a meaningful security improvement.\n |\n */\n\n 'cookie' => env(\n 'SESSION_COOKIE',\n Str::slug((string) env('APP_NAME', 'laravel')).'-session'\n ),\n\n /*\n |--------------------------------------------------------------------------\n | Session Cookie Path\n |--------------------------------------------------------------------------\n |\n | The session cookie path determines the path for which the cookie will\n | be regarded as available. Typically, this will be the root path of\n | your application, but you're free to change this when necessary.\n |\n */\n\n 'path' => env('SESSION_PATH', '/'),\n\n /*\n |--------------------------------------------------------------------------\n | Session Cookie Domain\n |--------------------------------------------------------------------------\n |\n | This value determines the domain and subdomains the session cookie is\n | available to. By default, the cookie will be available to the root\n | domain without subdomains. Typically, this shouldn't be changed.\n |\n */\n\n 'domain' => env('SESSION_DOMAIN'),\n\n /*\n |--------------------------------------------------------------------------\n | HTTPS Only Cookies\n |--------------------------------------------------------------------------\n |\n | By setting this option to true, session cookies will only be sent back\n | to the server if the browser has a HTTPS connection. This will keep\n | the cookie from being sent to you when it can't be done securely.\n |\n */\n\n 'secure' => env('SESSION_SECURE_COOKIE'),\n\n /*\n |--------------------------------------------------------------------------\n | HTTP Access Only\n |--------------------------------------------------------------------------\n |\n | Setting this value to true will prevent JavaScript from accessing the\n | value of the cookie and the cookie will only be accessible through\n | the HTTP protocol. It's unlikely you should disable this option.\n |\n */\n\n 'http_only' => env('SESSION_HTTP_ONLY', true),\n\n /*\n |--------------------------------------------------------------------------\n | Same-Site Cookies\n |--------------------------------------------------------------------------\n |\n | This option determines how your cookies behave when cross-site requests\n | take place, and can be used to mitigate CSRF attacks. By default, we\n | will set this value to \"lax\" to permit secure cross-site requests.\n |\n | See: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie#samesitesamesite-value\n |\n | Supported: \"lax\", \"strict\", \"none\", null\n |\n */\n\n 'same_site' => env('SESSION_SAME_SITE', 'lax'),\n\n /*\n |--------------------------------------------------------------------------\n | Partitioned Cookies\n |--------------------------------------------------------------------------\n |\n | Setting this value to true will tie the cookie to the top-level site for\n | a cross-site context. Partitioned cookies are accepted by the browser\n | when flagged \"secure\" and the Same-Site attribute is set to \"none\".\n |\n */\n\n 'partitioned' => env('SESSION_PARTITIONED_COOKIE', false),\n\n /*\n |--------------------------------------------------------------------------\n | Session Serialization\n |--------------------------------------------------------------------------\n |\n | This value controls the serialization strategy for session data, which\n | is JSON by default. Setting this to \"php\" allows the storage of PHP\n | objects in the session but can make an application vulnerable to\n | \"gadget chain\" serialization attacks if the APP_KEY is leaked.\n |\n | Supported: \"json\", \"php\"\n |\n */\n\n 'serialization' => 'json',\n\n];\n"
},
{
"path": "config/statamic/antlers.php",
"content": " env('STATAMIC_ANTLERS_DEBUGBAR', true),\n\n /*\n |--------------------------------------------------------------------------\n | Guarded Variables\n |--------------------------------------------------------------------------\n |\n | Any variable pattern that appears in this list will not be allowed\n | in any Antlers template, including any user-supplied values.\n |\n */\n\n 'guardedVariables' => [\n 'config.app.key',\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Guarded Tags\n |--------------------------------------------------------------------------\n |\n | Any tag pattern that appears in this list will not be allowed\n | in any Antlers template, including any user-supplied values.\n |\n */\n\n 'guardedTags' => [\n\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Guarded Modifiers\n |--------------------------------------------------------------------------\n |\n | Any modifier pattern that appears in this list will not be allowed\n | in any Antlers template, including any user-supplied values.\n |\n */\n\n 'guardedModifiers' => [\n\n ],\n\n];\n"
},
{
"path": "config/statamic/api.php",
"content": " env('STATAMIC_API_ENABLED', false),\n\n 'resources' => [\n 'collections' => false,\n 'navs' => false,\n 'taxonomies' => false,\n 'assets' => false,\n 'globals' => false,\n 'forms' => false,\n 'users' => false,\n ],\n\n 'route' => env('STATAMIC_API_ROUTE', 'api'),\n\n /*\n |--------------------------------------------------------------------------\n | Authentication\n |--------------------------------------------------------------------------\n |\n | By default, the API will be publicly accessible. However, you may define\n | an API token here which will be used to authenticate requests.\n |\n */\n\n 'auth_token' => env('STATAMIC_API_AUTH_TOKEN'),\n\n /*\n |--------------------------------------------------------------------------\n | Middleware\n |--------------------------------------------------------------------------\n |\n | Define the middleware / middleware group that will be applied to the\n | API route group. If you want to externally expose this API, here\n | you can configure a middleware-based authentication layer.\n |\n */\n\n 'middleware' => env('STATAMIC_API_MIDDLEWARE', 'api'),\n\n /*\n |--------------------------------------------------------------------------\n | Pagination\n |--------------------------------------------------------------------------\n |\n | The numbers of items to show on each paginated page.\n |\n */\n\n 'pagination_size' => 50,\n\n /*\n |--------------------------------------------------------------------------\n | Caching\n |--------------------------------------------------------------------------\n |\n | By default, Statamic will cache each endpoint until the specified\n | expiry, or until content is changed. See the documentation for\n | more details on how to customize your cache implementation.\n |\n | https://statamic.dev/content-api#caching\n |\n */\n\n 'cache' => [\n 'expiry' => 60,\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Exclude Keys\n |--------------------------------------------------------------------------\n |\n | Here you may provide an array of keys to be excluded from API responses.\n | For example, you may want to hide things like edit_url, api_url, etc.\n |\n */\n\n 'excluded_keys' => [\n //\n ],\n\n];"
},
{
"path": "config/statamic/assets.php",
"content": " [\n\n /*\n |--------------------------------------------------------------------------\n | Route Prefix\n |--------------------------------------------------------------------------\n |\n | The route prefix for serving HTTP based manipulated images through Glide.\n | If using the cached option, this should be the URL of the cached path.\n |\n */\n\n 'route' => 'img',\n\n /*\n |--------------------------------------------------------------------------\n | Require Glide security token\n |--------------------------------------------------------------------------\n |\n | With this option enabled, you are protecting your website from mass image\n | resize attacks. You will need to generate tokens using the Glide tag\n | but may want to disable this while in development to tinker.\n |\n */\n\n 'secure' => true,\n\n /*\n |--------------------------------------------------------------------------\n | Image Manipulation Driver\n |--------------------------------------------------------------------------\n |\n | The driver that will be used under the hood for image manipulation.\n | Supported: \"gd\", \"imagick\" or a class name of a custom driver.\n |\n */\n\n 'driver' => 'gd',\n\n /*\n |--------------------------------------------------------------------------\n | Save Cached Images\n |--------------------------------------------------------------------------\n |\n | Enabling this will make Glide save publicly accessible images. It will\n | increase performance at the cost of the dynamic nature of HTTP based\n | image manipulation. You will need to invalidate images manually.\n |\n */\n\n 'cache' => false,\n 'cache_path' => public_path('img'),\n\n /*\n |--------------------------------------------------------------------------\n | Image Manipulation Defaults\n |--------------------------------------------------------------------------\n |\n | You may define global defaults for all manipulation parameters, such as\n | quality, format, and sharpness. These can and will be overwritten\n | on the tag parameter level as well as the preset level.\n |\n */\n\n 'defaults' => [\n // 'quality' => 50,\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Image Manipulation Presets\n |--------------------------------------------------------------------------\n |\n | Rather than specifying your manipulation params in your templates with\n | the glide tag, you may define them here and reference their handles.\n | They may also be automatically generated when you upload assets.\n | Containers can be configured to warm these caches on upload.\n |\n */\n\n 'presets' => [\n // 'small' => ['w' => 200, 'h' => 200, 'q' => 75, 'fit' => 'crop'],\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Generate Image Manipulation Presets on Upload\n |--------------------------------------------------------------------------\n |\n | By default, presets will be automatically generated on upload, ensuring\n | the cached images are available when they are first used. You may opt\n | out of this behavior here and have the presets generated on demand.\n |\n */\n\n 'generate_presets_on_upload' => true,\n\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Auto-Crop Assets\n |--------------------------------------------------------------------------\n |\n | Enabling this will make Glide automatically crop assets at their focal\n | point (which is the center if no focal point is defined). Otherwise,\n | you will need to manually add any crop related parameters.\n |\n */\n\n 'auto_crop' => true,\n\n /*\n |--------------------------------------------------------------------------\n | Control Panel Thumbnail Restrictions\n |--------------------------------------------------------------------------\n |\n | Thumbnails will not be generated for any assets any larger (in either\n | axis) than the values listed below. This helps prevent memory usage\n | issues out of the box. You may increase or decrease as necessary.\n |\n */\n\n 'thumbnails' => [\n 'max_width' => 10000,\n 'max_height' => 10000,\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Control Panel Video Thumbnails\n |--------------------------------------------------------------------------\n |\n | When enabled, Statamic will generate thumbnails for videos.\n | Generated thumbnails are displayed in the Control Panel.\n |\n */\n\n 'video_thumbnails' => true,\n\n /*\n |--------------------------------------------------------------------------\n | File Previews with Google Docs\n |--------------------------------------------------------------------------\n |\n | Filetypes that cannot be rendered with HTML5 can opt into the Google Docs\n | Viewer. Google will get temporary access to these files so keep that in\n | mind for any privacy implications: https://policies.google.com/privacy\n |\n */\n\n 'google_docs_viewer' => false,\n\n /*\n |--------------------------------------------------------------------------\n | Cache Metadata\n |--------------------------------------------------------------------------\n |\n | Asset metadata (filesize, dimensions, custom data, etc) will get cached\n | to optimize performance, so that it will not need to be constantly\n | re-evaluated from disk. You may disable this option if you are\n | planning to continually modify the same asset repeatedly.\n |\n */\n\n 'cache_meta' => true,\n\n /*\n |--------------------------------------------------------------------------\n | Focal Point Editor\n |--------------------------------------------------------------------------\n |\n | When editing images in the Control Panel, there is an option to choose\n | a focal point. When working with third-party image providers such as\n | Cloudinary it can be useful to disable Statamic's built-in editor.\n |\n */\n\n 'focal_point_editor' => true,\n\n /*\n |--------------------------------------------------------------------------\n | Enforce Lowercase Filenames\n |--------------------------------------------------------------------------\n |\n | Control whether asset filenames will be converted to lowercase when\n | uploading and renaming. This can help you avoid file conflicts\n | when working in case-insensitive filesystem environments.\n |\n */\n\n 'lowercase' => true,\n\n /*\n |--------------------------------------------------------------------------\n | Additional Uploadable Extensions\n |--------------------------------------------------------------------------\n |\n | Statamic will only allow uploads of certain approved file extensions.\n | If you need to allow more file extensions, you may add them here.\n |\n */\n\n 'additional_uploadable_extensions' => [],\n\n /*\n |--------------------------------------------------------------------------\n | Additional Filename Character Replacements\n |--------------------------------------------------------------------------\n |\n | When uploading files, certain characters in filenames will be replaced\n | to ensure a safe filename. You may configure additional replacements.\n | These are in addition to the native ones. They are not overridable.\n |\n */\n\n 'additional_filename_replacements' => [],\n\n /*\n |--------------------------------------------------------------------------\n | SVG Sanitization\n |--------------------------------------------------------------------------\n |\n | Statamic will automatically sanitize SVG files when uploaded to avoid\n | potential security issues. However, if you have a valid reason for\n | disabling this, and you trust your users, you may do so here.\n |\n */\n\n 'svg_sanitization_on_upload' => true,\n\n /*\n |--------------------------------------------------------------------------\n | FFmpeg\n |--------------------------------------------------------------------------\n |\n | Statamic uses FFmpeg to extract thumbnails from videos to be shown in the\n | Control Panel. You may adjust the binary location and cache path here.\n |\n */\n\n 'ffmpeg' => [\n 'binary' => null,\n 'cache_path' => storage_path('statamic/glide/ffmpeg'),\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Replicator and Bard Set Preview Images\n |--------------------------------------------------------------------------\n |\n | Replicator and Bard sets may have preview images to give users a visual\n | representation of the content within. Here you may specify the asset\n | container and folder where these preview images are to be stored.\n |\n */\n\n 'set_preview_images' => [\n 'container' => 'assets',\n 'folder' => 'set-previews',\n ],\n\n];"
},
{
"path": "config/statamic/autosave.php",
"content": " false,\n\n /*\n |--------------------------------------------------------------------------\n | Default autosave interval\n |--------------------------------------------------------------------------\n |\n | The default value may be set here and will apply to all collections.\n | However, it is also possible to manually adjust the value in the\n | each collection's config file. By default, this is set to 5s.\n |\n */\n\n 'interval' => 5000,\n\n];\n"
},
{
"path": "config/statamic/cp.php",
"content": " env('CP_ENABLED', true),\n\n 'route' => env('CP_ROUTE', 'cp'),\n\n /*\n |--------------------------------------------------------------------------\n | Authentication\n |--------------------------------------------------------------------------\n |\n | Whether the Control Panel's authentication pages should be enabled,\n | and where users should be redirected in order to authenticate.\n |\n */\n\n 'auth' => [\n 'enabled' => true,\n 'redirect_to' => null,\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Start Page\n |--------------------------------------------------------------------------\n |\n | When a user logs into the Control Panel, they will be taken here.\n | For example: \"dashboard\", \"collections/pages\", etc.\n |\n */\n\n 'start_page' => 'dashboard',\n\n /*\n |--------------------------------------------------------------------------\n | Dashboard Widgets\n |--------------------------------------------------------------------------\n |\n | Here you may define any number of dashboard widgets. You're free to\n | use the same widget multiple times in different configurations.\n |\n */\n\n 'widgets' => [\n //\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Pagination\n |--------------------------------------------------------------------------\n |\n | Here you may define the default pagination size as well as the options\n | the user can select on any paginated listing in the Control Panel.\n |\n */\n\n 'pagination_size' => 50,\n\n 'pagination_size_options' => [10, 25, 50, 100, 500],\n\n /*\n |--------------------------------------------------------------------------\n | Links to Documentation\n |--------------------------------------------------------------------------\n |\n | Show contextual links to documentation throughout the Control Panel.\n |\n */\n\n 'link_to_docs' => env('STATAMIC_LINK_TO_DOCS', true),\n\n /*\n |--------------------------------------------------------------------------\n | Support Link\n |--------------------------------------------------------------------------\n |\n | Set the location of the support link in the header.\n |\n */\n\n 'support_url' => env('STATAMIC_SUPPORT_URL', 'https://statamic.com/support'),\n\n /*\n |--------------------------------------------------------------------------\n | White Labeling\n |--------------------------------------------------------------------------\n |\n | When in Pro Mode you may replace the Statamic name, logo, favicon,\n | and add your own CSS to the control panel to match your\n | company or client's brand.\n |\n */\n\n 'custom_cms_name' => env('STATAMIC_CUSTOM_CMS_NAME', 'Statamic'),\n\n 'custom_logo_url' => env('STATAMIC_CUSTOM_LOGO_URL', null),\n\n 'custom_dark_logo_url' => env('STATAMIC_CUSTOM_DARK_LOGO_URL', null),\n\n 'custom_logo_text' => env('STATAMIC_CUSTOM_LOGO_TEXT', null),\n\n 'custom_favicon_url' => env('STATAMIC_CUSTOM_FAVICON_URL', null),\n\n 'custom_css_url' => env('STATAMIC_CUSTOM_CSS_URL', null),\n\n /*\n |--------------------------------------------------------------------------\n | Thumbnails\n |--------------------------------------------------------------------------\n |\n | Here you may define additional CP asset thumbnail presets.\n |\n */\n\n 'thumbnail_presets' => [\n // 'medium' => 800,\n ],\n\n];"
},
{
"path": "config/statamic/editions.php",
"content": " env('STATAMIC_PRO_ENABLED', false),\n\n 'addons' => [\n //\n ],\n\n];\n"
},
{
"path": "config/statamic/forms.php",
"content": " resource_path('forms'),\n\n /*\n |--------------------------------------------------------------------------\n | Email View Folder\n |--------------------------------------------------------------------------\n |\n | The folder under resources/views where your email templates are found.\n |\n */\n\n 'email_view_folder' => null,\n\n /*\n |--------------------------------------------------------------------------\n | Send Email Job\n |--------------------------------------------------------------------------\n |\n | The class name of the job that will be used to send an email.\n |\n */\n\n 'send_email_job' => \\Statamic\\Forms\\SendEmail::class,\n\n /*\n |--------------------------------------------------------------------------\n | Exporters\n |--------------------------------------------------------------------------\n |\n | Here you may define all the available form submission exporters.\n | You may customize the options within each exporter's array.\n |\n */\n\n 'exporters' => [\n 'csv' => [\n 'class' => Statamic\\Forms\\Exporters\\CsvExporter::class,\n ],\n 'json' => [\n 'class' => Statamic\\Forms\\Exporters\\JsonExporter::class,\n ],\n ],\n\n];\n"
},
{
"path": "config/statamic/git.php",
"content": " env('STATAMIC_GIT_ENABLED', false),\n\n /*\n |--------------------------------------------------------------------------\n | Automatically Run\n |--------------------------------------------------------------------------\n |\n | By default, commits are automatically queued when `Saved` or `Deleted`\n | events are fired. If you prefer users to manually trigger commits\n | using the `Git` utility interface, you may set this to `false`.\n |\n | https://statamic.dev/git-automation#committing-changes\n |\n */\n\n 'automatic' => env('STATAMIC_GIT_AUTOMATIC', true),\n\n /*\n |--------------------------------------------------------------------------\n | Queue Connection\n |--------------------------------------------------------------------------\n |\n | You may choose which queue connection should be used when dispatching\n | commit jobs. Unless specified, the default connection will be used.\n |\n | https://statamic.dev/git-automation#queueing-commits\n |\n */\n\n 'queue_connection' => env('STATAMIC_GIT_QUEUE_CONNECTION'),\n\n /*\n |--------------------------------------------------------------------------\n | Dispatch Delay\n |--------------------------------------------------------------------------\n |\n | When `Saved` and `Deleted` events queue up commits, you may wish to\n | set a delay time in minutes for each queued job. This can allow\n | for more consolidated commits when you have multiple users\n | making simultaneous content changes to your repository.\n |\n | Note: Not supported by default `sync` queue driver.\n |\n */\n\n 'dispatch_delay' => env('STATAMIC_GIT_DISPATCH_DELAY', 0),\n\n /*\n |--------------------------------------------------------------------------\n | Git User\n |--------------------------------------------------------------------------\n |\n | The git user that will be used when committing changes. By default, it\n | will attempt to commit with the authenticated user's name and email\n | when possible, falling back to the below user when not available.\n |\n | https://statamic.dev/git-automation#git-user\n |\n */\n\n 'use_authenticated' => true,\n\n 'user' => [\n 'name' => env('STATAMIC_GIT_USER_NAME', 'Spock'),\n 'email' => env('STATAMIC_GIT_USER_EMAIL', 'spock@example.com'),\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Tracked Paths\n |--------------------------------------------------------------------------\n |\n | Define the tracked paths to be considered when staging changes. Default\n | stache and file locations are already set up for you, but feel free\n | to modify these paths to suit your storage config. Referencing\n | absolute paths to external repos is also completely valid.\n |\n */\n\n 'paths' => [\n base_path('content'),\n base_path('users'),\n resource_path('addons'),\n resource_path('blueprints'),\n resource_path('fieldsets'),\n resource_path('forms'),\n resource_path('users'),\n resource_path('preferences.yaml'),\n resource_path('sites.yaml'),\n storage_path('forms'),\n public_path('assets'),\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Git Binary\n |--------------------------------------------------------------------------\n |\n | By default, Statamic will try to use the \"git\" command, but you can set\n | an absolute path to the git binary if necessary for your environment.\n |\n */\n\n 'binary' => env('STATAMIC_GIT_BINARY', 'git'),\n\n /*\n |--------------------------------------------------------------------------\n | Commands\n |--------------------------------------------------------------------------\n |\n | Define a list commands to be run when Statamic is ready to `git add`\n | and `git commit` your changes. These commands will be run once\n | per repo, attempting to consolidate commits where possible.\n |\n | https://statamic.dev/git-automation#customizing-commits\n |\n */\n\n 'commands' => [\n '{{ git }} add {{ paths }}',\n '{{ git }} -c \"user.name={{ name }}\" -c \"user.email={{ email }}\" commit -m \"{{ message }}\"',\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Push\n |--------------------------------------------------------------------------\n |\n | Determine whether `git push` should be run after the commands above\n | have finished. This is disabled by default, but can be enabled\n | globally, or per environment using the provided variable.\n |\n | https://statamic.dev/git-automation#pushing-changes\n |\n */\n\n 'push' => env('STATAMIC_GIT_PUSH', false),\n\n /*\n |--------------------------------------------------------------------------\n | Ignored Events\n |--------------------------------------------------------------------------\n |\n | Statamic will listen on all `Saved` and `Deleted` events, as well\n | as any events registered by installed addons. If you wish to\n | ignore any specific events, you may reference them here.\n |\n */\n\n 'ignored_events' => [\n // \\Statamic\\Events\\UserSaved::class,\n // \\Statamic\\Events\\UserDeleted::class,\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Locale\n |--------------------------------------------------------------------------\n |\n | The locale to be used when translating commit messages, etc. By\n | default, the authenticated user's locale will be used, but\n | feel free to override this using the provided variable.\n |\n */\n\n 'locale' => env('STATAMIC_GIT_LOCALE', null),\n\n];\n"
},
{
"path": "config/statamic/graphql.php",
"content": " env('STATAMIC_GRAPHQL_ENABLED', false),\n\n 'resources' => [\n 'collections' => false,\n 'navs' => false,\n 'taxonomies' => false,\n 'assets' => false,\n 'globals' => false,\n 'forms' => false,\n 'sites' => false,\n 'users' => false,\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Queries\n |--------------------------------------------------------------------------\n |\n | Here you may list queries to be added to the Statamic schema.\n |\n | https://statamic.dev/graphql#custom-queries\n |\n */\n\n 'queries' => [\n //\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Mutations\n |--------------------------------------------------------------------------\n |\n | Here you may list mutations to be added to the Statamic schema.\n |\n | https://statamic.dev/graphql#custom-mutations\n */\n\n 'mutations' => [\n //\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Middleware\n |--------------------------------------------------------------------------\n |\n | Here you may list middleware to be added to the Statamic schema.\n |\n | https://statamic.dev/graphql#custom-middleware\n |\n */\n\n 'middleware' => [\n //\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Caching\n |--------------------------------------------------------------------------\n |\n | By default, Statamic will cache each request until the specified\n | expiry, or until content is changed. See the documentation for\n | more details on how to customize your cache implementation.\n |\n | https://statamic.dev/graphql#caching\n |\n */\n\n 'cache' => [\n 'expiry' => 60,\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Introspection\n |--------------------------------------------------------------------------\n |\n | Introspection queries allow a user to see the schema and will power\n | development tools. This is \"auto\" by default, which will enable\n | it locally and keep it disabled everywhere else for security.\n |\n */\n\n 'introspection' => env('STATAMIC_GRAPHQL_INTROSPECTION_ENABLED', 'auto'),\n\n];\n"
},
{
"path": "config/statamic/live_preview.php",
"content": " [\n 'Laptop' => ['width' => 1440, 'height' => 900],\n 'Tablet' => ['width' => 1024, 'height' => 786],\n 'Mobile' => ['width' => 375, 'height' => 812],\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Additional Inputs\n |--------------------------------------------------------------------------\n |\n | Additional fields may be added to the Live Preview header bar. You\n | may define a list of Vue components to be injected. Their values\n | will be added to the cascade on the front-end for you to use.\n |\n */\n\n 'inputs' => [\n //\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Force Reload Javascript Modules\n |--------------------------------------------------------------------------\n |\n | To force a reload, Live Preview appends a timestamp to the URL on\n | script tags of type 'module'. You may disable this behavior here.\n |\n */\n\n 'force_reload_js_modules' => true,\n\n /*\n |--------------------------------------------------------------------------\n | Hot Reload Contents\n |--------------------------------------------------------------------------\n |\n | Should the Live Preview embed be hot-reloaded when the content changes?\n | Only applies when \"Refresh\" is disabled on the live preview target.\n |\n */\n\n 'hot_reload_contents' => true,\n\n];"
},
{
"path": "config/statamic/markdown.php",
"content": " [\n\n 'default' => [\n 'heading_permalink' => [\n 'id_prefix' => '',\n 'fragment_prefix' => '',\n 'apply_id_to_heading' => true,\n 'html_class' => 'c-anchor',\n 'aria_hidden' => false,\n 'insert' => 'after',\n 'symbol' => '#',\n ],\n ],\n\n ],\n\n];\n"
},
{
"path": "config/statamic/oauth.php",
"content": " env('STATAMIC_OAUTH_ENABLED', false),\n\n 'email_login_enabled' => true,\n\n 'providers' => [\n // 'github',\n ],\n\n 'routes' => [\n 'login' => 'oauth/{provider}',\n 'callback' => 'oauth/{provider}/callback',\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Create User\n |--------------------------------------------------------------------------\n |\n | Whether or not a user account should be created upon authentication\n | with an OAuth provider. If disabled, a user account will be need\n | to be explicitly created ahead of time.\n |\n */\n\n 'create_user' => true,\n\n /*\n |--------------------------------------------------------------------------\n | Merge User Data\n |--------------------------------------------------------------------------\n |\n | When authenticating with an OAuth provider, the user data returned\n | such as their name will be merged with the existing user account.\n |\n */\n\n 'merge_user_data' => true,\n\n /*\n |--------------------------------------------------------------------------\n | Unauthorized Redirect\n |--------------------------------------------------------------------------\n |\n | This controls where the user is taken after authenticating with\n | an OAuth provider but their account is unauthorized. This may\n | happen when the create_user option has been set to false.\n |\n */\n\n 'unauthorized_redirect' => null,\n\n /*\n |--------------------------------------------------------------------------\n | Remember Me\n |--------------------------------------------------------------------------\n |\n | Whether or not the \"remember me\" functionality should be used when\n | authenticating using OAuth. When enabled, the user will remain\n | logged in indefinitely, or until they manually log out.\n |\n */\n\n 'remember_me' => true,\n\n];\n"
},
{
"path": "config/statamic/protect.php",
"content": " null,\n\n /*\n |--------------------------------------------------------------------------\n | Protection Schemes\n |--------------------------------------------------------------------------\n |\n | Here you may define all of the protection schemes for your application\n | as well as their drivers. You may even define multiple schemes for\n | the same driver to easily protect different types of pages.\n |\n | Supported drivers: \"ip_address\", \"auth\", \"password\"\n |\n */\n\n 'schemes' => [\n\n 'ip_address' => [\n 'driver' => 'ip_address',\n 'allowed' => ['127.0.0.1'],\n ],\n\n 'logged_in' => [\n 'driver' => 'auth',\n 'login_url' => '/login',\n 'append_redirect' => true,\n ],\n\n 'password' => [\n 'driver' => 'password',\n 'allowed' => ['secret'],\n 'field' => null,\n 'form_url' => null,\n ],\n\n ],\n\n];\n"
},
{
"path": "config/statamic/revisions.php",
"content": " env('STATAMIC_REVISIONS_ENABLED', false),\n\n];\n"
},
{
"path": "config/statamic/routes.php",
"content": " true,\n\n /*\n |--------------------------------------------------------------------------\n | Enable Route Bindings\n |--------------------------------------------------------------------------\n |\n | Whether route bindings for Statamic repositories (entry, taxonomy,\n | collections, etc) are enabled for front end routes. This may be\n | useful if you want to make your own custom routes with them.\n |\n */\n\n 'bindings' => false,\n\n /*\n |--------------------------------------------------------------------------\n | Action Route Prefix\n |--------------------------------------------------------------------------\n |\n | Some extensions may provide routes that go through the frontend of your\n | website. These URLs begin with the following prefix. We've chosen an\n | unobtrusive default but you are free to select whatever you want.\n |\n */\n\n 'action' => '!',\n\n /*\n |--------------------------------------------------------------------------\n | Middleware\n |--------------------------------------------------------------------------\n |\n | Define the middleware that will be applied to the web route group.\n |\n */\n\n 'middleware' => 'web',\n\n];\n"
},
{
"path": "config/statamic/search.php",
"content": " env('STATAMIC_DEFAULT_SEARCH_INDEX', 'docs-'.config('docs.version')),\n\n /*\n |--------------------------------------------------------------------------\n | Search Indexes\n |--------------------------------------------------------------------------\n |\n | Here you can define all of the available search indexes.\n |\n */\n\n 'indexes' => [\n\n 'docs-'.config('docs.version') => [\n 'driver' => env('SEARCH_DRIVER', 'meilisearch'),\n 'searchables' => ['docs:*', 'storybook:*'],\n 'fields' => [\n 'title',\n 'search_title',\n 'content',\n 'origin_title',\n 'search_content',\n 'additional_context',\n 'hierarchy_lvl0',\n 'hierarchy_lvl1',\n 'url',\n ],\n 'settings' => [\n 'rankingRules' => [\n 'words',\n 'typo',\n 'proximity',\n 'attribute',\n 'exactness',\n 'origin_title:desc',\n 'hierarchy_lvl0:asc',\n ],\n 'searchableAttributes' => [\n 'additional_context',\n 'hierarchy_lvl0',\n 'title',\n 'origin_title',\n 'search_title',\n 'search_content',\n 'hierarchy_lvl1',\n 'url',\n ],\n ],\n 'content_retriever' => App\\Search\\RequestContentRetriever::class,\n 'document_transformers' => [\n App\\Search\\DocTransformer::class,\n ],\n ],\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Driver Defaults\n |--------------------------------------------------------------------------\n |\n | Here you can specify default configuration to be applied to all indexes\n | that use the corresponding driver. For instance, if you have two\n | indexes that use the \"local\" driver, both of them can have the\n | same base configuration. You may override for each index.\n |\n */\n\n 'drivers' => [\n\n 'local' => [\n 'path' => storage_path('statamic/search'),\n ],\n\n 'algolia' => [\n 'credentials' => [\n 'id' => env('ALGOLIA_APP_ID', ''),\n 'secret' => env('ALGOLIA_SECRET', ''),\n ],\n ],\n\n 'meilisearch' => [\n 'credentials' => [\n 'url' => env('MEILISEARCH_HOST', 'http://localhost:7700'),\n 'secret' => env('MEILISEARCH_KEY', ''),\n ],\n ],\n\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Search Defaults\n |--------------------------------------------------------------------------\n |\n | Here you can specify default configuration to be applied to all indexes\n | regardless of the driver. You can override these per driver or per index.\n |\n */\n\n 'defaults' => [\n 'fields' => ['title'],\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Indexing Queue\n |--------------------------------------------------------------------------\n |\n | Here you may configure the queue name and connection used when indexing\n | documents.\n |\n */\n\n 'queue' => env('STATAMIC_SEARCH_QUEUE'),\n\n 'queue_connection' => env('STATAMIC_SEARCH_QUEUE_CONNECTION'),\n\n /*\n |--------------------------------------------------------------------------\n | Chunk Size\n |--------------------------------------------------------------------------\n |\n | Here you can configure the chunk size used when indexing documents.\n | The higher you make it, the more memory it will use, but the quicker\n | the indexing process will be.\n |\n */\n\n 'chunk_size' => 100,\n\n];\n"
},
{
"path": "config/statamic/stache.php",
"content": " env('STATAMIC_STACHE_WATCHER', 'auto'),\n\n /*\n |--------------------------------------------------------------------------\n | Cache Store\n |--------------------------------------------------------------------------\n |\n | Here you may configure which Cache Store the Stache uses.\n |\n */\n\n 'cache_store' => null,\n\n /*\n |--------------------------------------------------------------------------\n | Stores\n |--------------------------------------------------------------------------\n |\n | Here you may configure the stores that are used inside the Stache.\n |\n | https://statamic.dev/stache#stores\n |\n */\n\n 'stores' => [\n //\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Indexes\n |--------------------------------------------------------------------------\n |\n | Here you may define any additional indexes that will be inherited\n | by each store in the Stache. You may also define indexes on a\n | per-store level by adding an \"indexes\" key to its config.\n |\n */\n\n 'indexes' => [\n //\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Locking\n |--------------------------------------------------------------------------\n |\n | In order to prevent concurrent requests from updating the Stache at the\n | same time and wasting resources, it will be locked so that subsequent\n | requests will have to wait until the first one has been completed.\n |\n | https://statamic.dev/stache#locks\n |\n */\n\n 'lock' => [\n 'enabled' => true,\n 'timeout' => 30,\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Warming Optimization\n |--------------------------------------------------------------------------\n |\n | These options control performance optimizations during Stache warming.\n |\n */\n\n 'warming' => [\n // Enable parallel store processing for faster warming on multi-core systems\n 'parallel_processing' => env('STATAMIC_STACHE_PARALLEL_WARMING', false),\n\n // Maximum number of parallel processes (0 = auto-detect CPU cores)\n 'max_processes' => env('STATAMIC_STACHE_MAX_PROCESSES', 0),\n\n // Minimum number of stores required to enable parallel processing\n 'min_stores_for_parallel' => env('STATAMIC_STACHE_MIN_STORES_PARALLEL', 3),\n\n // Concurrency driver: 'process', 'fork', or 'sync'\n 'concurrency_driver' => env('STATAMIC_STACHE_CONCURRENCY_DRIVER', 'process'),\n ],\n\n];\n"
},
{
"path": "config/statamic/static_caching.php",
"content": " env('STATAMIC_STATIC_CACHING_STRATEGY', null),\n\n /*\n |--------------------------------------------------------------------------\n | Caching Strategies\n |--------------------------------------------------------------------------\n |\n | Here you may define all of the static caching strategies for your\n | application as well as their drivers.\n |\n | Supported drivers: \"application\", \"file\"\n |\n */\n\n 'strategies' => [\n\n 'half' => [\n 'driver' => 'application',\n 'expiry' => null,\n ],\n\n 'full' => [\n 'driver' => 'file',\n 'path' => public_path('static'),\n 'lock_hold_length' => 0,\n 'permissions' => [\n 'directory' => 0755,\n 'file' => 0644,\n ],\n ],\n\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Exclusions\n |--------------------------------------------------------------------------\n |\n | Here you may define a list of URLs to be excluded from static\n | caching. You may want to exclude URLs containing dynamic\n | elements like contact forms, or shopping carts.\n |\n */\n\n 'exclude' => [\n\n 'class' => null,\n\n 'urls' => [\n '/sitemap.xml',\n ],\n\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Invalidation Rules\n |--------------------------------------------------------------------------\n |\n | Here you may define the rules that trigger when and how content would be\n | flushed from the static cache. See the documentation for more details.\n | If a custom class is not defined, the default invalidator is used.\n |\n | https://statamic.dev/static-caching\n |\n */\n\n 'invalidation' => [\n\n 'class' => null,\n\n 'rules' => [\n //\n ],\n\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Ignoring Query Strings\n |--------------------------------------------------------------------------\n |\n | Statamic will cache pages of the same URL but with different query\n | parameters separately. This is useful for pages with pagination.\n | If you'd like to ignore the query strings, you may do so.\n |\n */\n\n 'ignore_query_strings' => false,\n\n 'allowed_query_strings' => [\n //\n ],\n\n 'disallowed_query_strings' => [\n //\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Nocache\n |--------------------------------------------------------------------------\n |\n | Here you may define where the nocache data is stored.\n |\n | https://statamic.dev/tags/nocache#database\n |\n | Supported drivers: \"cache\", \"database\"\n |\n */\n\n 'nocache' => 'cache',\n\n 'nocache_db_connection' => env('STATAMIC_NOCACHE_DB_CONNECTION'),\n\n /*\n |--------------------------------------------------------------------------\n | Replacers\n |--------------------------------------------------------------------------\n |\n | Here you may define replacers that dynamically replace content within\n | the response. Each replacer must implement the Replacer interface.\n |\n */\n\n 'replacers' => [\n \\Statamic\\StaticCaching\\Replacers\\CsrfTokenReplacer::class,\n \\Statamic\\StaticCaching\\Replacers\\NoCacheReplacer::class,\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Warm Queue\n |--------------------------------------------------------------------------\n |\n | Here you may define the queue name and connection\n | that will be used when warming the static cache and\n | optionally set the \"--insecure\" flag by default.\n |\n */\n\n 'warm_queue' => env('STATAMIC_STATIC_WARM_QUEUE'),\n\n 'warm_queue_connection' => env('STATAMIC_STATIC_WARM_QUEUE_CONNECTION'),\n\n 'warm_insecure' => env('STATAMIC_STATIC_WARM_INSECURE', false),\n\n /*\n |--------------------------------------------------------------------------\n | Background Re-cache\n |--------------------------------------------------------------------------\n |\n | When this is enabled, Statamic will re-cache URLs in the background,\n | overwriting the existing cache, without removing it first.\n |\n */\n\n 'background_recache' => env('STATAMIC_BACKGROUND_RECACHE', false),\n\n 'recache_token' => env('STATAMIC_RECACHE_TOKEN'),\n\n 'recache_token_parameter' => '__recache',\n\n /*\n |--------------------------------------------------------------------------\n | Shared Error Pages\n |--------------------------------------------------------------------------\n |\n | You may choose to share the same statically generated error page across\n | all errors. For example, the first time a 404 is encountered it will\n | be generated and cached, and then served for all subsequent 404s.\n |\n | This is only supported for half measure.\n |\n */\n\n 'share_errors' => false,\n\n];\n"
},
{
"path": "config/statamic/system.php",
"content": " env('STATAMIC_LICENSE_KEY'),\n\n /*\n |--------------------------------------------------------------------------\n | Enable Multi-site\n |--------------------------------------------------------------------------\n |\n | Whether Statamic's multi-site functionality should be enabled. It is\n | assumed Statamic Pro is also enabled. To get started, you can run\n | the `php please multisite` command to update your content file\n | structure, after which you can manage your sites in the CP.\n |\n | https://statamic.dev/multi-site\n |\n */\n\n 'multisite' => false,\n\n /*\n |--------------------------------------------------------------------------\n | Default Addons Paths\n |--------------------------------------------------------------------------\n |\n | When generating addons via `php please make:addon`, this path will be\n | used by default. You can still specify custom repository paths in\n | your composer.json, but this is the path used by the generator.\n |\n */\n\n 'addons_path' => base_path('addons'),\n\n /*\n |--------------------------------------------------------------------------\n | Blueprints Path\n |--------------------------------------------------------------------------\n |\n | Where your blueprint YAML files are stored.\n |\n */\n\n 'blueprints_path' => resource_path('blueprints'),\n\n /*\n |--------------------------------------------------------------------------\n | Fieldsets Path\n |--------------------------------------------------------------------------\n |\n | Where your fieldset YAML files are stored.\n |\n */\n\n 'fieldsets_path' => resource_path('fieldsets'),\n\n /*\n |--------------------------------------------------------------------------\n | Send the Powered-By Header\n |--------------------------------------------------------------------------\n |\n | Websites like builtwith.com use the X-Powered-By header to determine\n | what technologies are used on a particular site. By default, we'll\n | send this header, but you are absolutely allowed to disable it.\n |\n */\n\n 'send_powered_by_header' => true,\n\n /*\n |--------------------------------------------------------------------------\n | Date Format\n |--------------------------------------------------------------------------\n |\n | This format will be used whenever a Carbon date is cast to a string on\n | front-end routes. It doesn't affect how dates are formatted in the CP.\n | You can customize this format using PHP's date string constants.\n | Setting this value to null will use Carbon's default format.\n |\n | https://www.php.net/manual/en/function.date.php\n |\n */\n\n 'date_format' => 'F jS, Y',\n\n /*\n |--------------------------------------------------------------------------\n | Timezone\n |--------------------------------------------------------------------------\n |\n | Statamic will use this timezone when displaying dates on the front-end.\n | You can use any timezone supported by PHP. When set to null it will\n | fall back to the timezone defined in your `app.php` config file.\n |\n | https://www.php.net/manual/en/timezones.php\n |\n */\n\n 'display_timezone' => null,\n\n /*\n |--------------------------------------------------------------------------\n | Localize Dates in Modifiers\n |--------------------------------------------------------------------------\n |\n | When using date-related modifiers, Carbon instances will be in UTC.\n | Enabling this setting will ensure that dates get localized into\n | the timezone defined in `display_timezone`. Otherwise you'll\n | need to manually localize dates in all of your templates.\n |\n */\n\n 'localize_dates_in_modifiers' => true,\n\n /*\n |--------------------------------------------------------------------------\n | Default Character Set\n |--------------------------------------------------------------------------\n |\n | Statamic will use this character set when performing specific string\n | encoding and decoding operations; This does not apply everywhere.\n |\n */\n\n 'charset' => 'UTF-8',\n\n /*\n |--------------------------------------------------------------------------\n | Track Last Update\n |--------------------------------------------------------------------------\n |\n | Statamic will automatically set an `updated_at` timestamp (along with\n | `updated_by`, where applicable) when specific content is updated.\n | In some situations, you may wish disable this functionality.\n |\n */\n\n 'track_last_update' => false,\n\n /*\n |--------------------------------------------------------------------------\n | Enable Cache Tags\n |--------------------------------------------------------------------------\n |\n | Sometimes you'll want to be able to disable the {{ cache }} tags in\n | Antlers, so here is where you can do that. Otherwise, it will be\n | enabled all the time.\n |\n */\n\n 'cache_tags_enabled' => env('STATAMIC_CACHE_TAGS_ENABLED', true),\n\n /*\n |--------------------------------------------------------------------------\n | Intensive Operations\n |--------------------------------------------------------------------------\n |\n | Sometimes Statamic requires extra resources to complete intensive\n | operations. Here you may configure system resource limits for\n | those rare times when we need to turn things up to eleven!\n |\n */\n\n 'php_memory_limit' => '-1',\n 'php_max_execution_time' => '-1',\n 'ajax_timeout' => '600000',\n 'pcre_backtrack_limit' => '-1',\n\n /*\n |--------------------------------------------------------------------------\n | Debugbar Integration\n |--------------------------------------------------------------------------\n |\n | Statamic integrates with Laravel Debugbar to bring more detail to your\n | debugging experience. Here you may adjust various default options.\n |\n */\n\n 'debugbar' => [\n 'pretty_print_variables' => true,\n ],\n\n /*\n |--------------------------------------------------------------------------\n | ASCII\n |--------------------------------------------------------------------------\n |\n | During various string manipulations (e.g. slugification), Statamic will\n | need to make ASCII character conversions. Here you may define whether\n | or not extra characters get converted. e.g. \"%\" becomes \"percent\".\n |\n */\n\n 'ascii_replace_extra_symbols' => false,\n\n /*\n |--------------------------------------------------------------------------\n | Update References on Change\n |--------------------------------------------------------------------------\n |\n | With this enabled, Statamic will attempt to update references to assets\n | and terms when moving, renaming, replacing, deleting, etc. This will\n | be queued, but it can disabled as needed for performance reasons.\n |\n */\n\n 'update_references' => true,\n\n /*\n |--------------------------------------------------------------------------\n | Always Augment to Query\n |--------------------------------------------------------------------------\n |\n | By default, Statamic will augment relationship fields with max_items: 1\n | to the result of a query, for example an Entry instance. Setting this\n | to true will augment to the query builder instead of the result.\n |\n */\n\n 'always_augment_to_query' => false,\n\n /*\n |--------------------------------------------------------------------------\n | Row ID handle\n |--------------------------------------------------------------------------\n |\n | Rows in Grid, Replicator, and Bard fields will be given a unique ID using\n | the \"id\" field. You may need your own field named \"id\", in which case\n | you may customize the handle of the field that Statamic will use.\n |\n */\n\n 'row_id_handle' => 'id',\n\n /*\n |--------------------------------------------------------------------------\n | Fake SQL Queries\n |--------------------------------------------------------------------------\n |\n | Enable while using the flat-file Stache driver to show fake \"SQL\" query\n | approximations in your database debugging tools — including Debugbar,\n | Laravel Telescope, and Ray with the ray()->showQueries() helper.\n |\n */\n\n 'fake_sql_queries' => config('app.debug'),\n\n /*\n |--------------------------------------------------------------------------\n | Layout\n |--------------------------------------------------------------------------\n |\n | Define the default layout that will be used by views.\n |\n */\n\n 'layout' => env('STATAMIC_LAYOUT', 'layout'),\n\n /*\n |--------------------------------------------------------------------------\n | View Config Allowlist\n |--------------------------------------------------------------------------\n |\n | Config keys that are allowed to be accessed in Antlers templates. Use\n | '@default' to include Statamic's default list. Add 'docs' so the docs\n | version switcher can access config.docs.version and config.docs.versions.\n |\n */\n\n 'view_config_allowlist' => ['@default', 'docs'],\n\n];\n"
},
{
"path": "config/statamic/templates.php",
"content": " 'antlers',\n\n /*\n |--------------------------------------------------------------------------\n | Code Style\n |--------------------------------------------------------------------------\n |\n | Here you may configure the code generator's output style.\n |\n */\n\n 'style' => [\n 'line_ending' => 'auto',\n 'indent_type' => 'space',\n 'indent_size' => 4,\n 'final_newline' => false,\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Antlers Settings\n |--------------------------------------------------------------------------\n |\n | Antlers specific template generation settings.\n |\n */\n\n 'antlers' => [\n 'use_components' => false,\n ],\n];"
},
{
"path": "config/statamic/users.php",
"content": " 'file',\n\n 'repositories' => [\n\n 'file' => [\n 'driver' => 'file',\n 'paths' => [\n 'roles' => resource_path('users/roles.yaml'),\n 'groups' => resource_path('users/groups.yaml'),\n ],\n ],\n\n 'eloquent' => [\n 'driver' => 'eloquent',\n ],\n\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Avatars\n |--------------------------------------------------------------------------\n |\n | User avatars are initials by default, with custom options for services\n | like Gravatar.com.\n |\n | Supported: \"initials\", \"gravatar\", or a custom class name.\n |\n */\n\n 'avatars' => 'initials',\n\n /*\n |--------------------------------------------------------------------------\n | New User Roles\n |--------------------------------------------------------------------------\n |\n | When registering new users through the user:register_form tag, these\n | roles will automatically be applied to your newly created users.\n |\n */\n\n 'new_user_roles' => [\n //\n ],\n\n /*\n |--------------------------------------------------------------------------\n | New User Groups\n |--------------------------------------------------------------------------\n |\n | When registering new users through the user:register_form tag, these\n | groups will automatically be applied to your newly created users.\n |\n */\n\n 'new_user_groups' => [\n //\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Registration form honeypot field\n |--------------------------------------------------------------------------\n |\n | When registering new users through the user:register_form tag,\n | specify the field to act as a honeypot for bots\n |\n */\n\n 'registration_form_honeypot_field' => null,\n\n /*\n |--------------------------------------------------------------------------\n | User Wizard Invitation Email\n |--------------------------------------------------------------------------\n |\n | When creating new users through the wizard in the control panel,\n | you may choose whether to be able to send an invitation email.\n | Setting to true will give the user the option. But setting\n | it to false will disable the invitation option entirely.\n |\n */\n\n 'wizard_invitation' => true,\n\n /*\n |--------------------------------------------------------------------------\n | Password Brokers\n |--------------------------------------------------------------------------\n |\n | When resetting passwords, Statamic uses an appropriate password broker.\n | Here you may define which broker should be used for each situation.\n | You may want a longer expiry for user activations, for example.\n |\n */\n\n 'passwords' => [\n 'resets' => 'users',\n 'activations' => 'activations',\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Database\n |--------------------------------------------------------------------------\n |\n | Here you may configure the database connection and its table names.\n |\n */\n\n 'database' => config('database.default'),\n\n 'tables' => [\n 'users' => 'users',\n 'role_user' => 'role_user',\n 'roles' => false,\n 'group_user' => 'group_user',\n 'groups' => false,\n 'webauthn' => 'webauthn',\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Authentication Guards\n |--------------------------------------------------------------------------\n |\n | By default, Statamic will use the `web` authentication guard. However,\n | if you want to run Statamic alongside the default Laravel auth\n | guard, you can configure that for your cp and/or frontend.\n |\n */\n\n 'guards' => [\n 'cp' => 'web',\n 'web' => 'web',\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Impersonation\n |--------------------------------------------------------------------------\n |\n | Here you can configure if impersonation is available, and what URL to\n | redirect to after impersonation begins.\n |\n */\n\n 'impersonate' => [\n 'enabled' => env('STATAMIC_IMPERSONATE_ENABLED', true),\n 'redirect' => env('STATAMIC_IMPERSONATE_REDIRECT', null),\n ],\n\n /*\n |--------------------------------------------------------------------------\n | Elevated Sessions\n |--------------------------------------------------------------------------\n |\n | Users may be required to reauthorize before performing certain\n | sensitive actions. This is called an elevated session. Here\n | you may configure the duration of the session in minutes.\n |\n */\n\n 'elevated_session_duration' => 15,\n\n /*\n |--------------------------------------------------------------------------\n | Enforce Two-Factor Authentication\n |--------------------------------------------------------------------------\n |\n | Specify which user roles should be required to enable two-factor\n | authentication. Use \"*\" to enforce 2FA for all users, or \"super_users\"\n | to enforce it for super users.\n |\n */\n\n 'two_factor_enforced_roles' => [],\n\n /*\n |--------------------------------------------------------------------------\n | Default Sorting\n |--------------------------------------------------------------------------\n |\n | Here you may configure the default sort behavior for user listings.\n |\n */\n\n 'sort_field' => 'email',\n 'sort_direction' => 'asc',\n\n];\n"
},
{
"path": "config/statamic/webauthn.php",
"content": " true,\n\n /*\n |--------------------------------------------------------------------------\n | Remember Me\n |--------------------------------------------------------------------------\n |\n | Whether or not the \"remember me\" functionality should be used when\n | authenticating using WebAuthn. When enabled, the user will remain\n | logged in indefinitely, or until they manually log out.\n |\n */\n\n 'remember_me' => true,\n\n /*\n |--------------------------------------------------------------------------\n | Model\n |--------------------------------------------------------------------------\n |\n | When using eloquent passkeys you can specify the model you want to use\n |\n */\n\n 'model' => \\Statamic\\Auth\\Eloquent\\WebAuthnModel::class,\n\n];"
},
{
"path": "config/torchlight.php",
"content": " env('TORCHLIGHT_CACHE_DRIVER'),\n\n // Which theme you want to use. You can find all of the themes at\n // https://torchlight.dev/docs/themes.\n 'theme' => env('TORCHLIGHT_THEME', 'synthwave-84'),\n\n // Your API token from torchlight.dev.\n 'token' => env('TORCHLIGHT_TOKEN'),\n\n // If you want to register the blade directives, set this to true.\n 'blade_components' => false,\n\n // The Host of the API.\n 'host' => env('TORCHLIGHT_HOST', 'https://api.torchlight.dev'),\n\n // We replace tabs in your code blocks with spaces in HTML. Set\n // the number of spaces you'd like to use per tab. Set to\n // `false` to leave literal tabs in the HTML.\n 'tab_width' => 4,\n\n // If you pass a filename to the code component or in a markdown\n // block, Torchlight will look for code snippets in the\n // following directories.\n 'snippet_directories' => [\n resource_path(),\n ],\n\n // Global options to control blocks-level settings.\n // https://torchlight.dev/docs/options\n 'options' => [\n // Turn line numbers on or off globally.\n 'lineNumbers' => false,\n\n 'defaultLanguage' => 'antlers',\n\n // Control the `style` attribute applied to line numbers.\n // 'lineNumbersStyle' => '',\n\n 'fileStyle' => 'html',\n\n // Turn on +/- diff indicators.\n // 'diffIndicators' => true,\n\n // If there are any diff indicators for a line, put them\n // in place of the line number to save horizontal space.\n // 'diffIndicatorsInPlaceOfLineNumbers' => true,\n\n // When lines are collapsed, this is the text that will\n // be shown to indicate that they can be expanded.\n // 'summaryCollapsedIndicator' => '...',\n ],\n];\n"
},
{
"path": "content/assets/.gitkeep",
"content": ""
},
{
"path": "content/assets/main.yaml",
"content": "title: Main\ndisk: assets\n"
},
{
"path": "content/collections/.gitkeep",
"content": ""
},
{
"path": "content/collections/fieldtypes/array.md",
"content": "---\ntitle: Array\nmeta_title: Array Fieldtype\nintro: Manage data in a `key:value` array format.\noverview: |\n The array fieldtype is used to manage `key: value` array data. It's similar to the [table](/fieldtypes/table) fieldtype but with a more strict data structure and compact user interface.\nscreenshot: fieldtypes/screenshots/v6/array.webp\nscreenshot_dark: fieldtypes/screenshots/v6/array-dark.webp\noptions:\n -\n name: keys\n type: array\n description: >\n Define keys when using [keyed mode](#keyed-mode).\n Default: `null`.\n -\n name: mode\n type: string\n description: \"Determine which [mode](#modes) to use. Default: `dynamic`.\"\n -\n name: value_header\n type: string\n description: >\n **Value** column heading displayed when using [dynamic mode](#dynamic-mode)\n Default: `Value`.\n -\n name: key_header\n type: string\n description: >\n **Key** column heading displayed when using [dynamic mode](#dynamic-mode)\n Default: `Key`.\n -\n name: add_button\n type: string\n description: >\n Add button text customization.\n Default: `Add Row`.\n -\n name: expand\n type: boolean\n description: >\n Save the field as an ordered list of `key` / `value` objects instead of a flat YAML mapping.\n Enable when you need numeric keys, stable option order with database-backed content stores, or to avoid YAML limitations with certain key types.\n Default: `false`.\nid: 457f17eb-c0ee-4345-bf90-88322abc212d\n---\n## Overview\n\nThis fieldtype is used to manage `key: value` array data in the right situation. It's used for situations when there is data you would like to stay grouped together because there's only _one_ set and you don't want to use loops.\n\nIf you'd like to have _lists_ of this type of data, you might want to use a [grid](/fieldtypes/grid) or [replicator](/fieldtypes/replicator) field.\n\n## Modes\n\nThe screenshot above depicts the three modes you can choose from. Two for when you know there is a fixed set of keys (keyed/single), and one for when you don't (dynamic).\n\n### Keyed Mode\n\nThe first field contains pre-defined keys. This will give the user a stricter input. They can only enter the values for the specified keys, and they cannot be reordered.\n\n```yaml\naddress:\n type: array\n keys:\n street: Street\n city: City\n country: Country\n```\n\nThe keys can be specified with or without labels. The snippet above (and what's shown in the screenshot) uses labels.\n\nThe following is an example of just keys. When using this syntax, the key and the label will be identical.\n\n```\nkeys:\n - street\n - city\n - country\n```\n\n### Single Mode\n\nExactly the same restrictions and setup as keyed mode, except the user can only manage an array one item at a time, using a select box to switch between keys.\n\n### Dynamic Mode\n\nThe second field contains no pre-defined keys. This will allow the user to define them on the fly and re-arrange them.\n\n```yaml\naddress:\n type: array\n```\nColumn headings can be set with `value_header` & `key_header`.\n```\nvalue_header: Type of Bacon\nkey_header: Why is it awesome?\n```\n\n### Expanded storage (`expand`) {#expanded-storage}\n\nBy default, array data is stored as a YAML mapping (`key: value`). Set `expand: true` to store it as an ordered list of objects instead:\n\n```yaml\n# expand: false (default)\nsizes:\n \"42\": Medium\n \"7\": Small\n\n# expand: true\nsizes:\n -\n key: \"42\"\n value: Medium\n -\n key: \"7\"\n value: Small\n```\n\nUse expanded storage when keys need to be **numbers** (YAML mappings treat numeric keys oddly), when you rely on **explicit row order** (for example with the Eloquent Driver and MySQL, where key order on associative arrays is not preserved), or when you edit raw YAML and want unambiguous structure.\n\n```yaml\ninventory:\n type: array\n expand: true\n keys:\n sku: SKU\n qty: Quantity\n```\n\n[Augmentation](/augmentation) still exposes the field as a normal key/value structure for templates and Antlers, so `{{ inventory:sku }}` and nested variable syntax behave the same whether `expand` is on or off.\n\n\n## Data Structure\n\nIn the example above, the keyed mode and dynamic mode would save the exact same data (unless [expanded storage](#expanded-storage) is enabled—in that case the same logical keys are stored as a list of `key` / `value` objects).\n\n```yaml\naddress:\n street: 221B Baker Street\n city: London\n country: England\n```\n\nSingle mode will only save data if it has been entered by the user.\n\n```yaml\naddress:\n England: '221 Baker Street, London'\n```\n\n\n## Templating\n\nThis fieldtype _is not_ [augmented](/augmentation).\n\n\n::tabs\n\nYou can use basic array access, nested variables, or the [foreach tag](/tags/foreach) to loop through all of the keys. All three of the following methods are equivalent.\n\n```antlers\n// Array access\n{{ address }}\n {{ street }} {{ city }} {{ country }}\n{{ /address }}\n\n// Nested variables\n{{ address:street }} {{ address:city }} {{ address:country }}\n\n// Foreach tag:\n{{ foreach:address }}\n {{ value }}\n{{ /foreach:address }}\n```\n\n::tab\n\nYou can use basic array access or the `@foreach` directive to loop through all of the keys.\n\n```blade\n// Nested variables\n{{ $address['street'] }}\n{{ $address['city'] }}\n{{ $address['country'] }}\n\n// Using foreach\n@foreach ($address as $key => $value)\n\t{{ $key }}: {{ $value }}\n@endforeach\n```\n::"
},
{
"path": "content/collections/fieldtypes/assets.md",
"content": "---\ntitle: Assets\nmeta_title: Assets Fieldtype\nintro: Any time you want to list, display, or work with assets (external files with enhanced abilities), this is the way to do it. Upload, browse, reorder, delete, and even manage field data on individual assets.\ndescription: Upload files and use the Asset Browser to pick from existing files in your Asset Containers.\nscreenshot: fieldtypes/screenshots/v6/assets-list.webp\nscreenshot_dark: fieldtypes/screenshots/v6/assets-list-dark.webp\noptions:\n -\n name: allow_uploads\n type: bool\n description: |\n Enable to allow uploading new files into the container. Default: `true`.\n -\n name: container\n type: string\n description: |\n The name of the desired [asset container](/assets#containers) to use for browsing, uploading, and managing assets. _Required when the site has more than one container._\n -\n name: folder\n type: string\n description: >\n The folder (relative to the container) to begin browsing. Default: the root folder of the container.\n -\n name: dynamic\n type: string\n description:\n Assets will be placed in a subfolder based on the value of this field. See [dynamic folders](#dynamic-folders). You may use `id`, `slug`, or `author`.\n -\n name: min_files\n type: int\n description: >\n The minimum number of allowed files. Leave empty for no minimum.\n -\n name: max_files\n type: int\n description: >\n The maximum number of allowed files. Set to `null` for unlimited. If set to `1`, will be saved as a string instead of an array. Default: `null`.\n -\n name: mode\n type: string\n description: >\n Set to `list` to use the table layout mode, and `grid` to use the grid mode with larger thumbnails. Default: `grid`.\n -\n name: query_scopes\n type: string\n description: >\n Allows you to specify a [query scope](/extending/query-scopes-and-filters#scopes) which should be applied when retrieving selectable assets. You should specify the query scope's handle, which is usually the name of the class in snake case. For example: `MyAwesomeScope` would be `my_awesome_scope`.\n -\n name: restrict\n type: bool\n description: >\n If `true`, navigation within the asset browser will be disabled. Your users will be restricted to a specified container and folder. Default: `false`.\n\nid: d0c65546-74f1-4a15-89d5-1562a95ee2c6\n---\n## Overview\n\nThe assets fieldtype is used to manage and relate files with your entries. From the fieldtype you can manage custom fields on the assets themselves (learn more about that in the [assets guide](/assets)), preview full size images or rich media files, and even set focal points for cropping.\n\nFiles are rearrangeable via drag-and-drop.\n\n## UI Modes\n\nThe list mode is shown in the previous screenshot, while the grid mode is shown below. There are no functional differences, only visual ones. List mode is more compact – useful if you're not primarily managing images.\n\n\n \n \n List mode reveals a fanny pack in all its glory. And if you’re British—go on, have a little chuckle.\n\n\n## Data Structure\n\nData is stored as an array of image paths _relative to the asset container_. Each asset's full URL is generated dynamically on the frontend based on the image path and its container. This allows containers to be a bit more portable by avoiding fully hardcoded file paths.\n\nIf `max_files` is set to `1`, a string will be saved instead of an array.\n\n``` yaml\n# Default YAML\ngallery_images:\n - fresh-prince.jpg\n - dj-jazzy-jeff.jpg\n - uncle-phil.jpg\n\n# With max_files: 1\nhero_image: surf-boards.jpg\n```\n\n## Templating\n\nThe Asset fieldtype uses [augmentation](/augmentation) to automatically relate the files with their Asset records, pull in custom and meta data, and resolve all image paths based on the container.\n\n::tabs\n\nBy using a tag pair syntax, you'll be able to output variables for each asset:\n\n```antlers\n{{ gallery_images }}\n \n{{ /gallery_images }}\n\n{{ hero_image }}\n \n{{ /hero_image }}\n```\n::tab\n\nYou can use the `@foreach` directive to loop over each asset and output its variables:\n\n```blade\n@foreach ($gallery_images as $asset)\n url }}\" alt=\"{{ $asset->alt }}\" />\n@endforeach\n\n{{-- Assuming $hero_image is max_files: 1 --}}\nurl }}\" alt=\"{{ $hero_image->alt }}\" />\n```\n\n::\n\n\n```html\n\n\n\n\n\n```\n\nThe same tag pair syntax can be used regardless of your `max_files` setting.\n\n::tabs\n\nIf you have `max_files: 1`, you can also use a single tag syntax to directly use a variable inside the asset. Without a second tag part, the URL will be used.\n\n```antlers\n{{ hero_image }}\n{{ hero_image:url }}\n{{ hero_image:alt }}\n```\n\n::tab\n\nIf you have `max_files: 1`, you can use property access to output variables within the asset. When output as a string, the URL will be used.\n\n```blade\n{{ $hero_image }}\n{{ $hero_image->url }}\n{{ $hero_image->alt }}\n```\n\n::\n\n```html\n/assets/surf-boards.jpg\n/assets/surf-boards.jpg\n3 colorful surf boards\n```\n\n### Variables\n\nInside an asset variable's tag pair you'll have access to the following variables.\n\n| Variable | Description |\n|----------|-------------|\n| `url` | Web-friendly URL to the file. |\n| `path` | Path to the file relative to asset container |\n| `permalink` | Absolute URL to the file including your site URL. |\n| `basename` | Name of the file with file extension |\n| `blueprint` | Which blueprint is managing the asset container |\n| `container` | Which asset container the file is in |\n| `edit_url` | URL to edit asset in the Control Panel |\n| `extension` | File extension |\n| `filename` | Name of the file without file extension |\n| `folder` | Which folder the file is in |\n| `is_audio` | `true` when file is one of `aac`, `flac`, `m4a`, `mp3`, `ogg`, or `wav`. |\n| `is_image` | `true` when file is one of `jpg`, `jpeg`, `png`, `gif`, or `webp`. |\n| `is_svg` | `true` when file is an `svg`. |\n| `is_video` | `true` when file is one of `h264`, `mp4`, `m4v`, `ogv`, or `webm`. |\n| `last_modified` | Formatted date string of the last modified time |\n| `last_modified_instance` | [Carbon][carbon] instance of the last modified time |\n| `last_modified_timestamp` | Unix timestamp of the last modified time |\n| `size` | Pre-formatted file size (`3.48 MB`) |\n| `size_b` | File size in bytes |\n| `size_kb` | File size in kilobytes |\n| `size_mb` | File size in megabytes |\n| `size_gb` | File size in gigabytes |\n\n### Image Assets\n\n| Variable | Description |\n|----------|-------------|\n| `height` | height of an image, in pixels |\n| `width` | width of an image, in pixels |\n| `focus_css` | CSS `background-image` property for a focal point\n| `orientation` | Is one of `portrait`, `landscape`, `square`, or `null`. |\n| `ratio` | An image's ratio (`1.77`) |\n\n:::tip\nYou can use [Glide](/tags/glide) to crop, flip, sharpen, pixelate, and perform other sweet image manipulations.\n:::\n\n### Asset Field Data\n\n::tabs\nAll custom data set on the assets will also be available inside the asset tag loop.\n\n```antlers\n{{ gallery_images }}\n \n \n {{ caption }}\n \n{{ /gallery_images }}\n```\n\n::tab\n\nAll custom data set on the assets will also be available on the asset instance.\n\n```blade\n@foreach ($gallery_images as $image)\n url }}\" alt=\"{{ $image->alt }}\" />\n\n @if ($caption = $image->caption)\n {{ $caption }}\n @endif\n@endforeach\n```\n\n::\n\n## Dynamic Folders\n\nIn addition to selecting which container and folder assets will be uploaded into, you may configure the field to have a dedicated subfolder based on an entry's value.\n\nFor example, you may want to place all the images for a blog post in its own directory.\n\n```yaml\ntype: assets\ncontainer: images\nfolder: blog\ndynamic: slug\n```\n\nThis would result in `image.jpg` being uploaded to `path/to/images/blog/my-entry-slug/image.jpg`.\n\nYou may target the entry's `id`, `slug`, or `author` values.\n\n:::warning\nThe values are *not* kept in sync. For example, if you change the entry's slug, the asset folder will not be renamed. You may rename the folder manually via a control on the field, or within the asset browser.\n:::\n\n\n[carbon]: https://carbon.nesbot.com/docs/\n"
},
{
"path": "content/collections/fieldtypes/bard.md",
"content": "---\ntitle: Bard\ndescription: \"Rich article writing and block-based layouts made easy.\"\nintro: |\n Bard is more than just a content editor, and more flexible than a block-based editor. **It is designed to provide a delightful and powerful writing experience** with unparalleled flexibility on your front-end.\nscreenshot: fieldtypes/screenshots/v6/bard-with-sets.webp\nscreenshot_dark: fieldtypes/screenshots/v6/bard-with-sets-dark.webp\noptions:\n -\n name: allow_source\n type: boolean\n description: |\n Controls whether the \"show source code\" button is available to your editors. Default: `true`.\n -\n name: sets\n type: array\n description: An array containing sets of fields. If you don't provide any sets, Bard will act like a basic text/WYSIWYG editor and you won't see the \"Add Set\" button.\n -\n name: buttons\n type: array\n description: |\n An array of buttons you want available in the toolbar.\n You can choose from `h1`, `h2`, `h3`, `h4`, `h5`, `h6`, `bold`, `italic`, `small`, `underline`, `strikethrough`, `unorderedlist`, `orderedlist`, `removeformat`, `quote`, `anchor`, `image`, `table`, `code` (inline), `codeblock`, and `horizontalrule`.\n\n These are the defaults:\n  {.mt-4}\n\n You can override the default buttons using the `Bard::setDefaultButtons()` method:\n ```php\n \\Statamic\\Fieldtypes\\Bard::setDefaultButtons(['h2', 'h3', 'bold', 'italic']);\n ```\n\n When you have the `image` button toggled, make sure to define an Asset Container in the Bard field's settings, otherwise the button won't show.\n -\n name: target_blank\n type: boolean\n description: |\n Automatically add `target=\"_blank\"` on links by default. You'll be able to override this per-link. Default: `false`.\n -\n name: link_noopener\n type: boolean\n description: |\n Set `rel=\"noopener\"` on all created links. Default: `false`.\n -\n name: link_noreferrer\n type: boolean\n description: |\n Set `rel=\"noreferrer\"` on all created links. Default: `false`.\n -\n name: fullscreen\n type: boolean\n description: |\n Enable the option to toggle into fullscreen mode. Default: `true`.\n -\n name: collapse\n type: boolean\n description: >\n Expand (`true`) or collapse (`false`) all sets by default. Default: `false`.\n -\n name: container\n type: string\n description: >\n An asset container ID. When specified, the fieldtype will allow the user to add a link to an asset from the specified container.\n -\n name: inline\n type: boolean\n description: |\n Switch the field to inline mode. Block elements such as sets, headings and images are not supported in inline mode and should not be enabled.\n -\n name: inline_hard_breaks\n type: boolean\n description: |\n Enable support for hard breaks in inline mode. Only works when `inline` is set to `true`. Default: `false`.\n -\n name: toolbar_mode\n type: string\n description: >\n Choose which style of toolbar you prefer, `fixed` or `floating`. Default: `fixed`.\n -\n name: reading_time\n type: boolean\n description: >\n Show estimated reading time at the bottom of the field. Default: `false`.\n -\n name: word_count\n type: boolean\n description: >\n Show the word count at the bottom of the field. Default: `false`.\n -\n name: save_html\n type: boolean\n description: >\n Save as HTML instead of structured data. This simplifies templates so you don't need to loop through the structured nodes. Only works while no sets are defined. Default: `false`.\n -\n name: always_show_set_button\n type: boolean\n description: >\n Always show the \"Add Set\" button. Default: `false`.\n -\n name: remove_empty_nodes\n type: string\n description: >\n Choose how to deal with empty nodes. Options: `false`, `true`, `trim`. Default: `false`.\n\nid: f4bf58d3-cbce-4957-b883-d92fd4791e89\n---\n## Overview\n\nBard is our recommended fieldtype for creating long form content from the control panel. It's highly configurable, intuitive, user-friendly, and writes impeccable HTML (thanks to [ProseMirror][prosemirror]).\n\nBard also has the ability to manage \"sets\" of fields inline with your text. These sets can contain any number of other fields of any [fieldtype](/fieldtypes), and can be collapsed and neatly rearranged in your content.\n\n## Working With Sets {#sets}\n\nYou can use any fieldtypes inside your Bard sets. Make sure to compare the experience with the other meta-fields: [Grid](/fieldtypes/grid) and [Replicator](/fieldtypes/replicator). You can even use Grids and Replicators inside your Bard sets. Just remember that because you can doesn't mean you should. Your UI experience can vary greatly.\n\n### Set Previews\n\nNew to Statamic v6, you can add an image preview of your set, _as well as_ an icon. Previews make it easy to identify sets by showing a screenshot of what the rendered set might look like on the front-end. Clients can now say “ah, that one” without pretending to know the names you carefully gave them.\n\n#### Configuring Set Previews\n\nTo add a set preview, click the little \"pencil\" icon next to the set name.\n\n\n \n \n Let's give the set a preview.\n\n\nOnce you're in the set editor, you can add a preview image and icon. Here we're showing a lovely screenshot of what the newsletter signup form might look like on the front-end. We can even add some instructions to explain how the set is used.\n\n\n \n \n Behold a Preview Image, for the love of all clients.\n\n\n#### Set Previews in Action\n\nOnce you've set a preview image, users adding a bard set can hover over the set to preview what it might look like on the frontend.\n\nYou can view previews in two different UI modes: in a list of set names, or in a grid of sets with their preview images.\n\n\n \n \n A preview in a list of sets.\n\n\n\n \n \n A preview in a grid of sets. Previews fall back to the set icon if no preview image is set.\n\n\n### Custom Set Icons\n\nYou can change the icons available in the set picker by configuring an icon set in a service provider.\n\nFor example, you can drop this into your `AppServiceProvider`'s `boot` method:\n\n```php\nuse Statamic\\Fieldtypes\\Sets;\n\npublic function boot()\n{\n Sets::useIcons('heroicons', resource_path('svg/heroicons'));\n}\n```\n\n## Data Structure\n\nBard stores your data as a [ProseMirror document](https://prosemirror.net/docs/ref/#model.Document_Structure). You should never need to interact with this data directly, thanks to [augmentation](/augmentation).\n\n## Templating\n\n### Without Sets\n\nIf you are using Bard just as a rich text editor and have no need for sets you would use a single tag to render the content.\n\n::tabs\n\n```antlers\n{{ bard_field }}\n```\n\n::tab\n\n```blade\n{!! $bard_field !!}\n```\n\n::\n\n### With Sets\n\nWhen working with sets, you should use the tag pair syntax and `if/else` conditions on the `type` variable to style each set accordingly. **Note**: any content that is entered _not_ in a set (i.e. your normal rich-text content) needs to be rendered using the \"text\" type. See the first condition using \"text.\"\n\n::tabs\n\n```antlers\n{{ bard_field }}\n\n {{ if type == \"text\" }}\n
\n\t@endif\n@endforeach\n```\n\n::\n\nAn alternative approach (for those who like DRY or small templates) is to create multiple \"set\" partials and pass the data to them dynamically, moving the markup into corresponding partials bearing the set's name.\n\n::tabs\n\n::tab antlers\n\n```antlers\n{{ bard_field }}\n {{ partial src=\"sets/{type}\" }}\n{{ /bard_field }}\n```\n\n``` files theme:serendipity-light\nresources/views/partials/sets/\n gallery.antlers.html\n hero_image.antlers.html\n poll.antlers.html\n text.antlers.html\n video.antlers.html\n```\n\n::tab blade\n\n:::tip\nBy using `[...$set]`, you can access the set variables within the set's Blade file without having to reference `$set` for each variable.\n\nFor example, `{!! $set->text !!}` becomes `{!! $text !!}`.\n:::\n\n```blade\n@foreach ($bard_field_with_sets as $set)\n\t@include('fieldtypes.bard.sets.'.$set->type, [...$set])\n@endforeach\n```\n\n``` files theme:serendipity-light\nresources/views/partials/sets/\n gallery.blade.php\n hero_image.blade.php\n poll.blade.php\n text.blade.php\n video.blade.php\n```\n\n::\n\n## Extending Bard\n\nBard uses [TipTap](https://tiptap.dev/) (which in turn is built on top of [ProseMirror][prosemirror]) as the foundation for our quintessential block-based editor.\n\n[prosemirror]: https://prosemirror.net/\n\n### Required Reading\n\nBefore you attempt to create any Bard extensions, it is wise to learn how to write a Tiptap extension first. Otherwise you'd be trying to learn how to ride a motorcycle before you can even ride a bike. Or a unicycle before you can juggle. To have a better understanding of how to write a Tiptap extension, you'd in turn benefit greatly on reading about how ProseMirror works.\n\n:::tip\nWriting custom extensions for Bard is pretty complicated, but can be rewarding and provide powerful results.\n:::\n\nIn short, here's a quick-start of the things you should probably start with:\n\n- [The ProseMirror guide](https://prosemirror.net/docs/guide/) — Yes, it's really long, but you should at least pretend to read it\n- Checking out the [The Tiptap documentation](https://tiptap.dev/docs/editor/getting-started/overview) and [code samples for the core Tiptap extensions](https://github.com/ueberdosis/tiptap/tree/develop/packages), so you can understand how Tiptap relates to ProseMirror\n- If you don't know [how to extend the control panel](/control-panel/css-javascript) yet, go ahead and read up on that first. The code snippets later will be part of your extension to the control panel. Alternatively, you may also [extend the control panel through the creation of an addon](/addons/building-an-addon).\n- Come back here again and keep on going.\n\n### Adding New Extensions\n\nYou may add your own Tiptap extensions to Bard using the `addExtension` method. The callback may return a single extension, or an array of them.\n\n``` js\nconst { Node, Mark, Extension } = Statamic.$bard.tiptap.core;\n\nStatamic.$bard.addExtension(() => Node.create({...}));\n```\n\n``` js\nStatamic.$bard.addExtension(() => {\n return [\n Node.create({...}),\n Mark.create({...}),\n Extension.create({...}),\n ]\n});\n```\n\nCheck out [Tiptap's custom extension documentation](https://tiptap.dev/docs/editor/extensions/custom-extensions) and [code samples for the core Tiptap extensions](https://github.com/ueberdosis/tiptap/tree/develop/packages) to find out how to write an extension.\n\nIf you're providing a new mark or node and intend to use this Bard field on the front-end, you will also need to create a Mark or Node class to be used by the PHP [renderer](#tiptap-php-rendering).\n\n:::tip\nIf you need any other Tiptap helpers or utilities you can use our [Tiptap API](#tiptap-api).\n:::\n\n### Replacing Existing Extensions\n\nIf you'd like to replace a [native extension](https://github.com/ueberdosis/tiptap/tree/develop/packages) (e.g. headings or paragraphs) you can use the `replaceExtension` method. It takes the `name` of the extension, and a callback that returns a single extension instance.\n\n```js\nconst { Node } = Statamic.$bard.tiptap.core;\n\nStatamic.$bard.replaceExtension('heading', ({ extension, bard }) => {\n return Node.create({\n name: 'heading',\n ...\n });\n});\n```\n\nThe callback will provide you with the existing extension instance, so if you are doing simple tweaks to an extension (e.g. customizing an input rule) you can simply extend the existing instance. Then you don't need to author an entire extension:\n\n```js\nconst { nodeInputRule } = Statamic.$bard.tiptap.core;\n\nStatamic.$bard.replaceExtension('heading', ({ extension, bard }) => {\n return extension.extend({\n addInputRules() {\n return [\n nodeInputRule({...}),\n ];\n },\n });\n});\n```\n\nYou can also reconfigure extensions (e.g. to add Tailwind classes to headings or disable specific \"smart typography\" rules):\n\n```js\nStatamic.$bard.replaceExtension('heading', ({ extension, bard }) => {\n return extension.configure({\n HTMLAttributes: {\n class: 'font-bold',\n },\n });\n});\n```\n```js\nStatamic.$bard.replaceExtension('typography', ({ extension, bard }) => {\n return extension.configure({\n oneHalf: false,\n oneQuarter: false,\n threeQuarters: false,\n });\n});\n```\n\n### Buttons\n\nTo add a button to the toolbar, provide a callback to the `buttons` method.\n\nThe callback will receive two arguments:\n- `buttons` - an array of the existing buttons in the toolbar (more about that in a moment)\n- `button` - a function that wraps your button objects\n\nThe callback may return a `button` object, or an array of them.\n\n``` js\nStatamic.$bard.buttons((buttons, button) => {\n return button({\n name: 'custom_bold',\n text: __('Custom Bold'), // Tooltip text\n svg: 'bold', // Name of an SVG icon\n html: '', // Custom icon HTML\n args: { class: 'font-bold' }, // The command arguments\n command: (editor, args) => editor.chain().focus().setCustomBold(args).run(), // The command to run\n activeName: 'customBold', // The active node/mark type that will activate this button (falls back to name)\n active: (editor, args) => editor.isActive('bold'), // Active check callback (overrides activeName)\n visibleWhenActive: 'example', // The active node/mark type that will show this button (always visible if not set)\n visible: (editor, args) => editor.isActive('example'), // Visible check callback (overrides visibleWhenActive)\n });\n});\n```\n\n``` js\nStatamic.$bard.buttons((buttons, button) => [\n button({...}),\n button({...}),\n]);\n```\n\nReturning values to the `buttons` method will push them onto the end. If you need more control, you can manipulate the supplied `buttons` argument, and then return nothing. For example, we'll add a button after wherever the existing bold button happens to be:\n\n``` js\nStatamic.$bard.buttons((buttons, button) => {\n const indexOfBold = _.findIndex(buttons, { name: 'bold' });\n\n buttons.splice(indexOfBold + 1, 0, button({...}));\n});\n```\n\n:::tip\nUsing the `button()` method will make the button only appear if the Bard field has been configured to show your button.\n\nIf you'd like your button to appear on all Bard fields, regardless of whether it's been configured to use that button, you can just return an object. Don't wrap with `button()`.\n:::\n\n### Tiptap API\n\nIn your extensions, you may need to use functions from the `tiptap` library. Rather than importing the library yourself and bloating your JS files, you may use methods through our API.\n\n``` js\nStatamic.$bard.tiptap.core; // `tiptap` (core, commands, utilities and helpers)\nStatamic.$bard.tiptap.pm.state; // `prosemirror-state`\nStatamic.$bard.tiptap.pm.model; // `prosemirror-model`\nStatamic.$bard.tiptap.pm.view; // `prosemirror-view`\n```\n\nYou could shorten things up by using destructuring. For example:\n\n``` js\nconst { InputRule, insertText, getAttributes } = Statamic.$bard.tiptap.core;\nnew InputRule(...);\ninsertText(...);\ngetAttributes(...);\n```\n\n### Tiptap PHP Rendering\n\nIf you have created an extension on the JS side to be used inside the Bard fieldtype, you will need to be able to render it on the PHP side (in your views).\n\nThe Bard `Augmentor` class is responsible for converting the ProseMirror structure to HTML.\n\nYou can use the `addExtension` or `replaceExtension` methods to bind an extension class into the renderer. Your AppServiceProvider's `boot` method is a good place to do this.\n\n``` php\nuse Statamic\\Fieldtypes\\Bard\\Augmentor;\n\npublic function boot()\n{\n // Pass an object\n Augmentor::addExtension('myExtension', new MyExtension);\n\n // or a closure. You will be passed the bard fieldtype and an array of options as arguments.\n Augmentor::addExtension('myExtension', function ($bard, $options) {\n return new MyExtension(['foo' => $bard->config('should_foo')];\n });\n\n // Same for replacing extensions.\n Augmentor::replaceExtension('paragraph', new MyCustomParagraph);\n\n // Closures too. There will be an additional argument at the front which is the existing extension.\n Augmentor::replaceExtension('paragraph', function ($existing, $bard, $options) {\n return new CustomParagraph;\n });\n}\n```\n\nCheck out [code samples for the core Tiptap extensions](https://github.com/ueberdosis/tiptap-php/tree/main/src) to find out how to write PHP extensions."
},
{
"path": "content/collections/fieldtypes/button_group.md",
"content": "---\ntitle: 'Button Group'\ndescription: 'Buttons you click. You can only choose one.'\nintro: |\n Buttons. Create some options and let your users select one and only one. May they choose wisely.\nscreenshot: fieldtypes/screenshots/v6/button-group.webp\nscreenshot_dark: fieldtypes/screenshots/v6/button-group-dark.webp\noptions:\n -\n name: clearable\n type: boolean\n description: |\n Allow deselecting all options, making `null` a possible value. Default: `false`.\n -\n name: options\n type: array\n description: 'Sets of key/value pairs define the values and labels of the buttons.'\nid: 26751221-fdc8-47c6-97f0-bf4997319482\n---\n## Overview\n\nThe button group fieldtype is a multiple choice input where you only get one choice. It saves the chosen option from a preset list.\n\n## Configuring\n\nUse the `options` setting to define a list of values and labels.\n\n``` yaml\nseat_choice:\n type: button_group\n instructions: Choose your airline seat. Choose wisely.\n options:\n left: Left\n middle: Middle\n right: Right\n```\n\nYou may omit the labels and just specify keys. If you use this syntax, the value and label will be identical.\n\n``` yaml\n options:\n - Left\n - Middle\n - Right\n```\n\n### Options in blueprint YAML\n\nLike the [select](/fieldtypes/select) fieldtype, `options` in the blueprint are saved in **expanded** form (ordered `key` / `value` rows) so option order is preserved in all storage backends. Hand-written blueprints should follow that structure if you are not using the visual editor.\n\n```yaml\noptions:\n - key: left\n value: Left\n - key: middle\n value: Middle\n```\n\n## Data Structure\n\nThe chosen option is stored as a string. If you only specified values for the `options` array, then the label will be saved.\n\n``` yaml\nseat_choice: middle\n```\n\n\n\n## Templating\n\nIt's a string, so you can just use that value.\n\n::tabs\n\n::tab antlers\n\n```\n
I love sitting in the {{ seat_choice }} seat. A lot.
\n```\n\n::tab blade\n\n```blade\n
I love sitting in the {{ $seat_choice }} seat. A lot.
\n```\n\n::\n\n```html\n
I love sitting in the middle seat. A lot.
\n```\n\n\n"
},
{
"path": "content/collections/fieldtypes/checkboxes.md",
"content": "---\ntitle: Checkboxes\ndescription: Boxes you check. You can check 'em all.\nintro: >\n Checkboxes! Make some checkboxes, click the checkboxes, and store a record of which boxes of which ones you clicked. They're boxes you check.\nscreenshot: fieldtypes/screenshots/v6/checkboxes.webp\nscreenshot_dark: fieldtypes/screenshots/v6/checkboxes-dark.webp\noptions:\n -\n name: inline\n type: bool\n description: >\n Show the checkboxes next to each other in a row instead of stacked vertically. Default: `false`\n -\n name: options\n type: array\n description: >\n Sets of key/value pairs define the values and labels of the checkbox options.\nid: f922cb9b-6fc9-4249-adf4-59aa46285c13\n---\n## Overview\n\nThe checkboxes fieldtype is a multiple choice input. It saves one or more options chosen from a preset list. In other words, they're boxes you check.\n\n## Configuring\n\nUse the `options` setting to define a list of values and labels.\n\n``` yaml\nfavorites:\n type: checkboxes\n instructions: Choose up to 3 favorite foods.\n options:\n donuts: Donuts\n icecream: Ice Cream\n brownies: Brownies\n```\n\nYou may omit the labels and just specify keys. If you use this syntax, the value and label will be identical.\n\n``` yaml\n options:\n - Donuts\n - Ice Cream\n - Brownies\n```\n\n### Options in blueprint YAML\n\nSee [Select · Options in blueprint YAML](/fieldtypes/select#options-in-blueprint-yaml)—checkbox options in the blueprint use the same expanded `key` / `value` rows so order is preserved everywhere.\n\n## Data Structure\n\nThe values are stored as a YAML array. If you only specified values for the `options` array, then the labels will be saved.\n\n``` yaml\nfavorites:\n - donuts\n - icecream\n```\n\n\n\n## Templating\n\nYou can loop through the checked items and access the value and label of each item inside the loop.\n\n::tabs\n\n::tab antlers\n\n```\n
\n{{ favorites }}\n
{{ value }}
\n{{ /favorites }}\n
\n```\n\n::tab blade\n\n```blade\n
\n\t@foreach($favorites as $favorite)\n\t{{-- You can also access $favorite['key'] and $favorite['label'] --}}\n\t
{{ $favorite['value'] }}
\n\t@endforeach\n
\n```\n\n::\n\n```html\n
\n
donuts
\n
icecream
\n
\n```\n\n::tabs\n\n::tab antlers\n\nTo conditionally check if a value has been selected, you can combine the [pluck](/modifiers/pluck) and [contains](/modifiers/contains) modifiers:\n\n```antlers\n{{ if favorites | pluck('value') | contains('donuts') }}\n Contains donuts! \n{{ /if }}\n```\n\n::tab blade\n\nTo conditionally check if a value has been selected, you can combine the pluck and contains collection methods:\n\n```blade\n@if (collect($favorites)->pluck('value')->contains('donuts'))\n\tContains donuts!\n@endif\n```\n::\n\n### Variables\n\nInside an asset variable's tag pair you'll have access to the following variables.\n\n| Variable | Description |\n|----------|-------------|\n| `key` | The zero-index count of the current item |\n| `value` | The stored value of the checkbox |\n| `label` | The label of the checkbox item from the field config |\n\n\n"
},
{
"path": "content/collections/fieldtypes/code.md",
"content": "---\ntitle: Code\ndescription: 'Write code and see it highlight. But will you choose spaces or tabs?'\nintro: What are you doing writing code in a browser?! Just kidding, it's fine. We made it easy, flexible, and pretty too. We use this fieldtype a lot.\n\nscreenshot: fieldtypes/screenshots/v6/code.webp\nscreenshot_dark: fieldtypes/screenshots/v6/code-dark.webp\noptions:\n -\n name: theme\n type: string\n description: |\n Choose between `light` and `material` (dark) themes. Default: `light`.\n -\n name: mode\n type: string\n description: |\n Set a default language for syntax highlighting. Your choices include:\n\n - `clike`\n - `css`\n - `diff`\n - `go`\n - `haml`\n - `handlebars`\n - `htmlmixed`\n - `less`\n - `markdown`\n - `gfm`\n - `nginx`\n - `text/x-java`\n - `javascript`\n - `jsx`\n - `text/x-objectivec`\n - `php`\n - `python`\n - `ruby`\n - `scss`\n - `shell`\n - `sql`\n - `twig`\n - `vue`\n - `xml`\n - `yaml-frontmatter`\n -\n name: mode_selectable\n type: boolean\n description: |\n Whether the `mode` can be selected by the user in the publish form. Enabling this will change the GraphQL\n type from a string to a Code type.\n -\n name: indent_type\n type: string\n description: |\n Choose between `tabs` and `spaces`. Choose wisely. Default: `tabs`.\n -\n name: indent_size\n type: integer\n description: |\n Set your preferred indentation size (in spaces). Default: `4`.\n -\n name: line_numbers\n type: boolean\n description: |\n Show line numbers.\n -\n name: line_wrapping\n type: boolean\n description: |\n Enable to wrap long lines of code instead of showing a horizontal scroll. Default: `true`.\n -\n name: key_map\n type: string\n description: |\n Pick your preferred set of keyboard shortcuts. Choose between `default`, `sublime`, and `vim`. We'll let you guess which one is default.\n -\n name: rulers\n type: array\n description: |\n You can set the columns and the line style (choose between `dashed` or `solid`) of any rulers you wish to use.\nid: 3ca28569-5b86-49a1-b620-ea3364561cde\n---\n## Overview\n\nIf your content involves code snippets, this is the fieldtype for you. It's a [CodeMirror](https://codemirror.net) field with 25 of the most common languages ready for highlighting, handles tabs and spaces, has a dark mode, and best of all — for you super nerds out there — a vim key binding.\n\n## Data Structure\n\nThe code fieldtype stores a string. Do whatever you'd like with it.\n\n``` yaml\ncode_snippet: |\n {{ code_snippet }}\n```\n\n::tab blade\n\n```blade\n
{!! $code_snippet !!}
\n```\n\n::\n\nYou're also able to use it as an array if you want to output the mode.\n\n::tabs\n\n::tab antlers\n\n```\n{{ code_snippet }}\n
\n```\n\n::\n\n### Variables\n\nInside an code fieldtype's tag pair you'll have access to the following variables.\n\n| Variable | Description |\n|----------|-------------|\n| `code` | The contents of the field. |\n| `mode` | The selected language mode. |\n"
},
{
"path": "content/collections/fieldtypes/collections.md",
"content": "---\ntitle: Collections\nextends: 9dd58c40-6e33-49c8-83fa-61a69f6371be\ndescription: Choose from one or more collections.\noverview: Allows you to choose one or more collections.\noptions:\n -\n name: max_items\n type: integer\n description: >\n The maximum number of items that may be selected. Setting this to `1` will change the UI to a dropdown.\nscreenshot: /fieldtypes/screenshots/collections.png\nid: 44c3da60-ef47-408e-afc4-a33026c86f5d\n---\n## Usage\n\nThis fieldtype is used to view and select from a list of Collections.\n\n```yaml\nfields:\n my_collections_field:\n type: collections\n```\n\n## Data Structure\n\nThe Collections fieldtype is a [Relationship fieldtype](/relationships#fieldtypes), and will save the collections as their handles (the folder name).\n\n```yaml\nlistings:\n - blog\n - things\n```\n\n## Templating\n\nYou're more than likely using this field as a way to dynamically display a collection.\n\n::tabs\n\n::tab antlers\n\nSince the collection tag accepts a pipe-delimited list of collection names, you can join them together like this:\n\n```antlers\n
\n {{ collection from=\"{listings|piped}\" }}\n
{{ title }}
\n {{ /collection }}\n
\n```\n\n::tab blade\n\nYou can pass the values from the collections fieldtype to the collection tag like so:\n\n```blade\n
\n\t\n\t\t
{{ $title }}
\n\t\n
\n\n```\n\n::\n\n```html\n
\n
A blog entry
\n
A thing entry
\n
etc
\n
\n```\n"
},
{
"path": "content/collections/fieldtypes/color.md",
"content": "---\ntitle: Color\ndescription: 'Manage colors by hex code with swatches and text inputs.'\nintro: 'A simple color picker with support for pre-defined swatches as well as entering a color by hex code.'\nscreenshot: fieldtypes/screenshots/v6/color.webp\nscreenshot_dark: fieldtypes/screenshots/v6/color-dark.webp\noptions:\n -\n name: swatches\n type: array\n description: |\n Pre-define colors that can be selected from a list. Supports all color mode formats.\n -\n name: allow_any\n type: boolean\n description: |\n Allow entering any color value via picker or hex code.\nid: 09b4af2d-265a-49ee-ac74-3e27041c180b\n---\n## Overview\n\nIf you want work with colors, this is the way to do it. You could combine it with [Bard](/fieldtypes/bard) or [Replicator](/fieldtypes/replicator) to create page \"page builders\", use it to choose background colors for headers or hero blocks, or even image overlays with `mix-blend-mode: multiply`. Go get creative!\n\n## Data Structure\n\nThe color fieldtype stores the color values as a hex string.\n\n``` yaml\nheader_color: \"#FF269E\"\n```\n\n## Templating\n\nThe color is output as a simple string. Most often you'll use this in an inline `style` tag to style elements of your front-end site.\n\n::tabs\n\n::tab antlers\n\n```antlers\n
\n
Bay Side High's Sweetheart Dance
\n
This Friday Night!
\n
\n```\n\n::tab blade\n\n```blade\n
\n\t
Bay Side High's Sweetheart Dance
\n\t
This Friday Night!
\n
\n```\n::"
},
{
"path": "content/collections/fieldtypes/date.md",
"content": "---\ntitle: Date\ndescription: Helps you pick a date, but not get one.\nintro: >\n Work with dates, times, and ranges with a variety of user interface options that make you really enjoy basically just picking numbers from a table.\nscreenshot: fieldtypes/screenshots/v6/date.webp\nscreenshot_dark: fieldtypes/screenshots/v6/date-dark.webp\noptions:\n -\n name: columns\n type: integer\n description: |\n Show multiple months at one time, in columns and rows. Default: `1`.\n -\n name: earliest_date\n type: string\n description: |\n Set the earliest selectable date in `YYYY-MM-DD` format. Default: `1900-01-01`.\n -\n name: format\n type: string\n description: |\n How the date should be stored, using the [PHP date format](https://www.php.net/manual/en/datetime.format.php). We recommend choosing a format which stores date & time.\n -\n name: full_width\n type: boolean\n description: |\n Enable to stretch the calendar out like Stretch Armstrong, using the maximum amount of available horizontal space. Default: `false`.\n -\n name: inline\n type: boolean\n description: |\n Always show the calendar instead of the text input and dropdown UI. Default: `false`.\n -\n name: mode\n type: string\n description: |\n Choose between `single` or `range`. Range mode disables the time picker. Default: `single`.\n -\n name: rows\n type: integer\n description: |\n Show multiple months at one time, in columns and rows. Default: `1`.\n -\n name: time_enabled\n type: boolean\n description: |\n Enable/disable the timepicker. Default: `false`.\n \n \n \n Now you can pick a time, too!\n \n -\n name: time_required\n type: boolean\n description: |\n Makes the time field visible and non-dismissible. Default: `false`.\n -\n name: timezone\n type: string\n description: |\n The timezone dates will be displayed and entered in within the Control Panel. Accepts any [IANA timezone](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) (e.g. `America/New_York`). Defaults to the site-wide [`default_timezone`](#control-panel-timezone) configured in `config/statamic/cp.php`, which itself defaults to `auto` (the browser's local timezone).\nid: 7dfba904-8a74-40e1-b507-51cd2b5f6123\n---\n\n## Overview\n\nDate fields have highly configurable user interfaces. They can be as simple as a single date and/or time, or as fancy as a multi-month calendar with multi-day range picking. Be sure to experiment with the various config [options](#options) to create the best experience for your content authors.\n\n## Data Structure\n\nSingle dates are stored as a date/timestring. Ranges are stored as an array with a `start` and `end` key.\n\n``` yaml\ndate: 1983-10-01 12:00:00\ndate_range:\n start: 2019-11-18 00:00\n end: 2019-11-22 00:00\n```\n\nDates are stored in your application's timezone. \n\nThe time will be when `time_enabled` is `true`, or depending on the timezone of the user who selected the date. e.g. On date fields where there is no time configured, it will assume midnight for the person who selected it.\n\n## Templating\n\nDate fields are [augmented](/augmentation) to return a [Carbon instance][carbon]. When used as a string they will return a pre-formatting output that uses your `config.date` format setting. By default that'll look like `January 1, 2020`.\n\n### Date Ranges\n\nRanges have nested `start` and `end` variables, so you can access them like this:\n\n::tabs\n\n::tab antlers\n```antlers\n// Nested variable\nEvent: {{ date:start }} through {{ date:end }}\n\n// Tag pair\n{{ date }}\nEvent: {{ start }} through {{ end }}\n{{ /date }}\n```\n\n::tab blade\n\n```blade\nEvent: {{ $date_range['start'] }} through {{ $date_range['end'] }}\n```\n\n::\n\n\n \n \n Ranges are much simpler than two date fields.\n\n\n### Formatting Dates\n\nYou can format the output of your date fields with the [format modifier](/modifiers/format) and PHP's [date formatting options](https://www.php.net/manual/en/function.date.php).\n\n::tabs\n\n::tab antlers\n```antlers\n{{ date format=\"Y\" }} // 2019\n{{ date format=\"Y-m-d\" }} // 2019-10-10\n{{ date format=\"l, F jS\" }} // Sunday, January 21st\n```\n\n::tab blade\n\nWhen using Blade, you may also call the `->format` method on Carbon instances.\n\n```blade\n{{-- Using Modifiers --}}\n{{ Statamic::modify($date)->format('Y') }} // 2019\n{{ Statamic::modify($date)->format('Y-m-d') }} // 2019-10-10\n{{ Statamic::modify($date)->format('l, F jS') }} // Sunday, January 21st\n\n{{-- Using Carbon methods --}}\n{{ $date->format('Y') }} // 2019\n{{ $date->format('Y-m-d') }} // 2019-10-10\n{{ $date->format('l, F jS') }} // Sunday, January 21st\n```\n\n::\n\n### Formatting localized Dates\n\nYou can format localized dates with the [iso modifier](/modifiers/iso_format) and [ISO formatting options](https://carbon.nesbot.com/docs/#api-localization). This use Carbon's inner translations rather than language packages you need to install on every machine where you deploy your application.\n\n::tabs\n\n::tab antlers\n```antlers\n{{ date iso_format=\"YYYY\" }} // 2019\n{{ date iso_format=\"YYYY-MM-DD\" }} // 2019-10-10\n{{ date iso_format=\"dddd, MMMM Do\" }} // Sunday, January 21st\n```\n\n::tab blade\n\nWhen using Blade, you may also call the `->isoFormat` method on Carbon instances.\n\n```blade\n{{-- Using Modifiers --}}\n{{ Statamic::modify($date)->isoFormat('YYYY') }} // 2019\n{{ Statamic::modify($date)->isoFormat('YYYY-MM-DD') }} // 2019-10-10\n{{ Statamic::modify($date)->isoFormat('dddd, MMMM Do') }} // Sunday, January 21st\n\n{{-- Using Carbon methods --}}\n{{ $date->isoFormat('YYYY') }} // 2019\n{{ $date->isoFormat('YYYY-MM-DD') }} // 2019-10-10\n{{ $date->isoFormat('dddd, MMMM Do') }} // Sunday, January 21st\n\n```\n\n::\n\n## Timezones\n\nDates are stored in your application timezone, then converted before being displayed to users.\n\nFor more information on how Statamic handles timezones, please review our [Timezones](/tips/timezones) guide.\n\n### Control Panel Timezone\n\nBy default, dates in the Control Panel are displayed and entered in the browser's local timezone. This means a user in New York and a user in London editing the same entry would each see the date in their own timezone.\n\nIf you'd prefer all users to see and enter dates in a specific timezone, you can configure it site-wide in `config/statamic/cp.php`:\n\n```php\n'default_timezone' => env('STATAMIC_CP_DEFAULT_TIMEZONE', 'auto'),\n```\n\nSet this to any [IANA timezone](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) (e.g. `America/New_York`) to pin all date fields to that timezone. The default value of `auto` uses each user's browser timezone.\n\nYou can also override this on a per-field basis with the [`timezone`](#options) field config option.\n\n\n\n[carbon]: https://carbon.nesbot.com/docs/\n"
},
{
"path": "content/collections/fieldtypes/dictionary.md",
"content": "---\ntitle: Dictionary\ndescription: Choose from options provided by dictionaries.\nintro: Give your users a list of options to choose from. Similar to the Select field, but allows you to read options from YAML or JSON files, or even hit external APIs.\nscreenshot: fieldtypes/screenshots/v6/dictionary.webp\nscreenshot_dark: fieldtypes/screenshots/v6/dictionary-dark.webp\noptions:\n -\n name: dictionary\n type: array\n description: |\n Configure the dictionary to be used. You may also define any config values which should be passed along to the dictionary. The `dictionary` option accepts both string & array values:\n\n ```yaml\n # When it's a dictionary without any config fields...\n dictionary: countries\n\n # When it's a dictionary with config fields...\n dictionary:\n type: countries\n region: Europe\n ```\n -\n name: placeholder\n type: string\n description: |\n Set the non-selectable placeholder text. Default: none.\n -\n name: default\n type: string\n description: |\n Set the default option key. Default: none.\n -\n name: max_items\n type: integer\n description: >\n Cap the number of selections. Setting this to 1 will change the UI. Default: null (unlimited).\nid: 9b14b5b8-6a7a-4db2-8533-9c78faa0e054\n---\n## Overview\nAt a glance, the Dictionary fieldtype is similar to the [Select fieldtype](/fieldtypes/select). However, with the Dictionary fieldtype, options aren't manually defined in a field's config, but rather returned from a PHP class (called a \"dictionary\").\n\nThis can prove to be pretty powerful, since it means you can read options from YAML or JSON files, or even hit an external API. It also makes it easier to share common select options between projects.\n\n## Data Storage\nDictionary fields will store the \"key\" of the chosen option or options.\n\nFor example, a dictionary might have items such as:\n\n```php\n'jan' => 'January',\n'feb' => 'February',\n'mar' => 'March',\n```\n\nYour saved data will be:\n\n``` yaml\nselect: jan\n```\n\n## Templating\nDictionary fields will return the \"option data\" returned by the dictionary's `get` method. The shape of this data differs between dictionaries and is outlined below.\n\nFor example, using the built-in Countries dictionary, your template might look like this:\n\n```yaml\npast_vacations:\n - USA\n - AUS\n - CAN\n - DEU\n - GBR\n```\n\n::tabs\n\n::tab antlers\n\n```antlers\n
\n {{ past_vacations }}\n
{{ emoji }} {{ name }}
\n {{ /past_vacations }}\n
\n```\n\n::tab blade\n\n```blade\n
\n\t@foreach ($past_vacations as $vacation)\n\t
{{ $vacation['emoji'] }} {{ $vacation['name'] }}
\n\t@endforeach\n
\n```\n\n::\n\n```html\n
\n
🇺🇸 United States
\n
🇦🇺 Australia
\n
🇨🇦 Canada
\n
🇩🇪 Germany
\n
🇬🇧 United Kingdom
\n
\n```\n\n## Available Dictionaries\nStatamic includes a few dictionaries straight out of the box.\n\n### File\nThis allows you point to a file located in your `resources/dictionaries` directory to populate the options. The file can be `json`, `yaml`, or `csv`.\n\nEach option array should have `label` and `value` keys at the minimum. Any additional keys will be available when templating.\n\nYou may redefine which keys are used for the labels and values by providing them to your fieldtype config. In the following example, `name` is the label and `id` is the value. \n\n```json\n[\n {\"name\": \"Apple\", \"id\": \"apple\", \"emoji\": \"🍎\"},\n {\"name\": \"Banana\", \"id\": \"banana\", \"emoji\": \"🍌\"},\n {\"name\": \"Cherry\", \"id\": \"cherry\", \"emoji\": \"🍒\"},\n ...\n]\n```\n\n```yaml\n-\n handle: fruit\n field:\n type: dictionary\n dictionary:\n type: file\n filename: fruit.json\n label: name # optional, defaults to \"label\"\n value: id # optional, defaults to \"value\"\n```\n\nYou may provide enhanced labels using basic Antlers syntax. For example, to include the emoji before the fruit name, you can do this:\n\n```yaml\nlabel: '{{ emoji }} {{ name }}'\n```\n\n### Countries\nThis provides a list of countries with their ISO codes, region, subregion, and flag emoji.\n```yaml\n-\n handle: countries\n field:\n type: dictionary\n dictionary:\n type: countries\n region: 'oceania' # Optionally filter the countries by a region.\n # Supported options are: africa, americas, asia, europe, oceania, polar\n emojis: true # Whether flag emojis are in the labels. They're on by default.\n```\n```yaml\ncountries:\n - USA\n - AUS\n```\n\n::tabs\n\n::tab antlers\n\n```antlers\n{{ countries }}\n {{ emoji }} {{ name }}, {{ iso2 }}, {{ iso3 }}, {{ region }}, {{ subregion }}\n{{ /countries }}\n```\n\n::tab blade\n\n```blade\n@foreach ($countries as $country)\n\t{{ $country['emoji'] }} {{ $country['name'] }}, {{ $country['iso2'] }}, {{ $country['iso3'] }}, {{ $country['region'] }}, {{ $country['subregion'] }}\n@endforeach\n```\n\n::\n\n```\n🇺🇸 United States, US, USA, Americas, Northern America\n🇦🇺 Australia, AU, AUS, Oceania, Australia and New Zealand\n```\n\n### Timezones\nThis provides a list of timezones and their UTC offsets.\n\n```yaml\n-\n handle: timezones\n field:\n type: dictionary\n dictionary:\n type: timezones\n```\n```yaml\ntimezones:\n - America/New_York\n - Australia/Sydney\n```\n\n::tabs\n\n::tab antlers\n\n```antlers\n{{ timezones }}\n {{ name }} {{ offset }}\n{{ /timezones }}\n```\n\n::tab blade\n\n```blade\n@foreach ($timezones as $timezone)\n\t{{ $timezone['name'] }} {{ $timezone['offset'] }}\n@endforeach\n```\n\n::\n\n```\nAmerica/New_York -04:00\nAustralia/Sydney +10:00\n```\n\n### Currencies\nThis provides a list of currencies, with their codes, symbols, and decimals.\n\n```yaml\n-\n handle: currencies\n field:\n type: dictionary\n dictionary:\n type: currencies\n```\n```yaml\ncurrencies:\n - USD\n - HUF \n```\n\n::tabs\n\n::tab antlers\n\n```antlers\n{{ currencies }}\n {{ name }}, {{ code }}, {{ symbol }}, {{ decimals }}\n{{ /currencies }}\n```\n\n::tab blade\n\n```blade\n@foreach ($currencies as $currency)\n{{ $currency['name'] }}, {{ $currency['code'] }}, {{ $currency['symbol'] }}, {{ $currency['decimals'] }}\n@endforeach\n```\n\n::\n\n```\nUS Dollar, USD, $, 2\nHungarian Forint, HUF, Ft, 0\n```\n\n## Custom Dictionaries\n\nIn many cases, using the native [File](#file) dictionary can be all you need for something custom. However, it's possible to create an entirely custom dictionary that could read from files, APIs, or whatever you can think of.\n\n[Find out how to create a custom dictionary](/extending/dictionaries)\n"
},
{
"path": "content/collections/fieldtypes/entries.md",
"content": "---\ntitle: Entries\nmeta_title: 'Entries Fieldtype'\ndescription: 'Create relationships with other entries.'\nintro: |\n Create relationships with other entries in one or more collections. It's not very much like online dating because you can create and link the entries on the fly without leaving the page.\nscreenshot: fieldtypes/screenshots/v6/entries.webp\nscreenshot_dark: fieldtypes/screenshots/v6/entries-dark.webp\noptions:\n -\n name: collections\n type: array\n description: |\n Configure which collections you want to allow relationships with.\n -\n name: create\n type: boolean\n description: |\n By default you may create new entries. Set to `false` to only allow selecting from existing entries. Only available in the `default` mode.\n -\n name: max_items\n type: integer\n description: >\n The maximum number of items that may be selected. Setting this to `1` will change the UI to a dropdown.\n -\n name: mode\n type: string\n description: |\n Set the UI style for this field. Can be one of 'default' (Stack Selector), 'select' (Select Dropdown) or 'typeahead' (Typeahead Field).\n -\n name: query_scopes\n type: string\n description: >\n Allows you to specify a [query scope](/extending/query-scopes-and-filters#scopes) which should be applied when retrieving selectable entries. You should specify the query scope's handle, which is usually the name of the class in snake case. For example: `MyAwesomeScope` would be `my_awesome_scope`.\n -\n name: search_index\n type: string\n description: >\n Allows you to specify a [search index](/search#indexes) to be used when searching for entries.\n -\n name: select_across_sites\n type: boolean\n description: |\n When enabled, entries from all sites will be displayed. \nid: acee879a-c832-449d-a714-c57ea5862717\n---\n## Overview\n\nUse this fieldtype to create a one-way relationship with entries of any collection in your site. It's delightfully simple.\n\n:::watch https://youtube.com/embed/WWbsM5u9afc\nWatch how to build a \"Related Articles\" feature using the Entries Fieldtype\n:::\n\n## Data Structure\n\nThis fieldtype will store an array of ids to the selected entries. They will be augmented in your Antlers templates to give you access to each entry's data.\n\n``` yaml\nrelated_entries:\n - 12f9be1f-a12e-4680-b769-639d2d1f1d14\n - ea48926d-bf67-4d45-9420-9627a31c37fb\n ```\n\n## Templating\n\nLoop through the entries and do anything you want with the data.\n\n::tabs\n\n::tab antlers\n```antlers\n
\n```\n"
},
{
"path": "content/collections/fieldtypes/float.md",
"content": "---\ntitle: Float\ndescription: 'For when all you want is decimal numbers.'\nintro: 'The float fieldtype is a text-style input that only accepts floats (numbers) and has increment and decrement controls.'\nscreenshot: fieldtypes/screenshots/v6/float.webp\nscreenshot_dark: fieldtypes/screenshots/v6/float-dark.webp\nid: 3dcf9495-9a02-4044-b6bb-428b7ff23807\noptions:\n -\n name: append\n type: string\n description: >\n Add text after (to the right of) the float input.\n -\n name: prepend\n type: string\n description: >\n Add text to the beginning (to the left of) the float input.\n -\n name: placeholder\n type: int\n description: >\n Set a default placeholder value.\n -\n name: min\n type: int\n description: >\n Set the minimum allowed value.\n -\n name: max\n type: int\n description: >\n Set the maximum allowed value.\n -\n name: step\n type: int\n description: >\n Set the interval between valid numbers.\n---\n## Overview\n\nThe float fieldtype is essentially an HTML5 input with `type=\"number\"`. Very similar to the [Integer fieldtype](/fieldtypes/integer), but it allows decimal numbers.\n\n## Data Storage\n\nStores a float – a decimal number.\n"
},
{
"path": "content/collections/fieldtypes/form.md",
"content": "---\nid: d630ea15-d94f-4404-84d2-0926a898e672\nblueprint: fieldtype\ntitle: Form\nscreenshot: fieldtypes/screenshots/v6/form.webp\nscreenshot_dark: fieldtypes/screenshots/v6/form-dark.webp\ndescription: 'Pick a form, any form.'\noverview: |\n Use this fieldtype to create a relationship with one of your site's [forms](/forms).\noptions:\n -\n name: max_items\n type: integer\n required: false\n description: 'The maximum number of forms that may be selected.'\n -\n name: placeholder\n type: string\n description: |\n Set the non-selectable placeholder text. Default: none.\n -\n name: query_scopes\n type: string\n description: >\n Allows you to specify a [query scope](/extending/query-scopes-and-filters#scopes) which should be applied when retrieving selectable assets. You should specify the query scope's handle, which is usually the name of the class in snake case. For example: `MyAwesomeScope` would be `my_awesome_scope`.\nrelated_entries:\n - fdb45b84-3568-437d-84f7-e3c93b6da3e6\n - aa96fcf1-510c-404b-9b63-cea8942e1bf8\n---\n## Overview\n\nThe Form fieldtype is gives your users a way to pick a form to include along with the current entry. How that form is implemented or shows up on the page is up to you.\n\n## Data Storage\n\nThe Form fieldtype stores the `handle` of a single form as a string, or an array of handles if `max_items` is greater than 1.\n\n## Templating\n\nThe Form fieldtype provides a few useful variables:\n\n* `handle`\n* `title`\n* `fields`\n* `api_url`\n* `honeypot`\n\nYou can use the [`form:create`](/tags/form-create) tag to render a `
![\"Statamic](\"https://statamic.com/assets/branding/Statamic-Logo+Wordmark-Rad.svg\")
![\"A](\"/img/tip-troll.webp\")
'\n : '';\n\n return new HtmlElement(\n 'div',\n $attrs,\n \"\\n\".\n $title.\"\\n\".\n $content.\n $mascot.\n \"\\n\"\n );\n }\n\n private function renderWatch(Hint $node, ChildNodeRendererInterface $childRenderer, array $attrs)\n {\n // Strip all HTML tags except for essential formatting elements (links, code, bold, italic)\n // This ensures the caption is rendered as plain text without unwanted p tags or other wrappers\n $caption = strip_tags($childRenderer->renderNodes($node->children()), '![\"{{](\"{{)
\n{{ /gallery_images }}\n\n{{ hero_image }}\n ![\"Will](\"/assets/fresh-prince.jpg\")
\n![\"Jeffrey](\"/assets/dj-jazzy-jeff.jpg\")
\n![\"James](\"/assets/uncle-phil.jpg\")
\n\n![\"3](\"/assets/surf-boards.jpg\")
\n```\n\nThe same tag pair syntax can be used regardless of your `max_files` setting.\n\n::tabs\n\nIf you have `max_files: 1`, you can also use a single tag syntax to directly use a variable inside the asset. Without a second tag part, the URL will be used.\n\n```antlers\n{{ hero_image }}\n{{ hero_image:url }}\n{{ hero_image:alt }}\n```\n\n::tab\n\nIf you have `max_files: 1`, you can use property access to output variables within the asset. When output as a string, the URL will be used.\n\n```blade\n{{ $hero_image }}\n{{ $hero_image->url }}\n{{ $hero_image->alt }}\n```\n\n::\n\n```html\n/assets/surf-boards.jpg\n/assets/surf-boards.jpg\n3 colorful surf boards\n```\n\n### Variables\n\nInside an asset variable's tag pair you'll have access to the following variables.\n\n| Variable | Description |\n|----------|-------------|\n| `url` | Web-friendly URL to the file. |\n| `path` | Path to the file relative to asset container |\n| `permalink` | Absolute URL to the file including your site URL. |\n| `basename` | Name of the file with file extension |\n| `blueprint` | Which blueprint is managing the asset container |\n| `container` | Which asset container the file is in |\n| `edit_url` | URL to edit asset in the Control Panel |\n| `extension` | File extension |\n| `filename` | Name of the file without file extension |\n| `folder` | Which folder the file is in |\n| `is_audio` | `true` when file is one of `aac`, `flac`, `m4a`, `mp3`, `ogg`, or `wav`. |\n| `is_image` | `true` when file is one of `jpg`, `jpeg`, `png`, `gif`, or `webp`. |\n| `is_svg` | `true` when file is an `svg`. |\n| `is_video` | `true` when file is one of `h264`, `mp4`, `m4v`, `ogv`, or `webm`. |\n| `last_modified` | Formatted date string of the last modified time |\n| `last_modified_instance` | [Carbon][carbon] instance of the last modified time |\n| `last_modified_timestamp` | Unix timestamp of the last modified time |\n| `size` | Pre-formatted file size (`3.48 MB`) |\n| `size_b` | File size in bytes |\n| `size_kb` | File size in kilobytes |\n| `size_mb` | File size in megabytes |\n| `size_gb` | File size in gigabytes |\n\n### Image Assets\n\n| Variable | Description |\n|----------|-------------|\n| `height` | height of an image, in pixels |\n| `width` | width of an image, in pixels |\n| `focus_css` | CSS `background-image` property for a focal point\n| `orientation` | Is one of `portrait`, `landscape`, `square`, or `null`. |\n| `ratio` | An image's ratio (`1.77`) |\n\n:::tip\nYou can use [Glide](/tags/glide) to crop, flip, sharpen, pixelate, and perform other sweet image manipulations.\n:::\n\n### Asset Field Data\n\n::tabs\nAll custom data set on the assets will also be available inside the asset tag loop.\n\n```antlers\n{{ gallery_images }}\n ![\"Assets](\"/img/fieldtypes/screenshots/v6/assets-grid.webp\")
\n ![\"Assets](\"/img/fieldtypes/screenshots/v6/assets-grid-dark.webp\")
\n ![\"Bard](\"/img/fieldtypes/screenshots/v6/bard-set-edit-preview.webp\")
\n ![\"Bard](\"/img/fieldtypes/screenshots/v6/bard-set-edit-preview-dark.webp\")
\n ![\"Bard](\"/img/fieldtypes/screenshots/v6/bard-set-previews.webp\")
\n ![\"Bard](\"/img/fieldtypes/screenshots/v6/bard-set-previews-dark.webp\")
\n ![\"Bard](\"/img/fieldtypes/screenshots/v6/bard-hover-preview-list.webp\")
\n ![\"Bard](\"/img/fieldtypes/screenshots/v6/bard-hover-preview-list-dark.webp\")
\n ![\"Bard](\"/img/fieldtypes/screenshots/v6/bard-hover-preview-grid.webp\")
\n ![\"Bard](\"/img/fieldtypes/screenshots/v6/bard-hover-preview-grid-dark.webp\")
\n ![\"Date](\"/img/fieldtypes/screenshots/v6/date-and-time.webp\")
\n ![\"Date](\"/img/fieldtypes/screenshots/v6/date-and-time-dark.webp\")
\n ![\"Date](\"/img/fieldtypes/screenshots/v6/date-range.webp\")
\n ![\"Date](\"/img/fieldtypes/screenshots/v6/date-range-dark.webp\")
\n