system.yaml 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180
  1. absolute_urls: false # Absolute or relative URLs for `base_url`
  2. timezone: '' # Valid values: http://php.net/manual/en/timezones.php
  3. default_locale: # Default locale (defaults to system)
  4. param_sep: ':' # Parameter separator, use ';' for Apache on windows
  5. wrapped_site: false # For themes/plugins to know if Grav is wrapped by another platform
  6. reverse_proxy_setup: false # Running in a reverse proxy scenario with different webserver ports than proxy
  7. force_ssl: false # If enabled, Grav forces to be accessed via HTTPS (NOTE: Not an ideal solution)
  8. force_lowercase_urls: true # If you want to support mixed cased URLs set this to false
  9. custom_base_url: '' # Set the base_url manually, e.g. http://yoursite.com/yourpath
  10. username_regex: '^[a-z0-9_-]{3,16}$' # Only lowercase chars, digits, dashes, underscores. 3 - 16 chars
  11. pwd_regex: '(?=.*\d)(?=.*[a-z])(?=.*[A-Z]).{8,}' # At least one number, one uppercase and lowercase letter, and be at least 8+ chars
  12. intl_enabled: true # Special logic for PHP International Extension (mod_intl)
  13. http_x_forwarded: # Configuration options for the various HTTP_X_FORWARD headers
  14. protocol: true
  15. host: false
  16. port: true
  17. ip: true
  18. languages:
  19. supported: [] # List of languages supported. eg: [en, fr, de]
  20. default_lang: # Default is the first supported language. Must be one of the supported languages
  21. include_default_lang: true # Include the default lang prefix in all URLs
  22. pages_fallback_only: false # Only fallback to find page content through supported languages
  23. translations: true # Enable translations by default
  24. translations_fallback: true # Fallback through supported translations if active lang doesn't exist
  25. session_store_active: false # Store active language in session
  26. http_accept_language: false # Attempt to set the language based on http_accept_language header in the browser
  27. override_locale: false # Override the default or system locale with language specific one
  28. home:
  29. alias: '/home' # Default path for home, ie /
  30. hide_in_urls: false # Hide the home route in URLs
  31. pages:
  32. theme: quark # Default theme (defaults to "quark" theme)
  33. order:
  34. by: default # Order pages by "default", "alpha" or "date"
  35. dir: asc # Default ordering direction, "asc" or "desc"
  36. list:
  37. count: 20 # Default item count per page
  38. dateformat:
  39. default: # The default date format Grav expects in the `date: ` field
  40. short: 'jS M Y' # Short date format
  41. long: 'F jS \a\t g:ia' # Long date format
  42. publish_dates: true # automatically publish/unpublish based on dates
  43. process:
  44. markdown: true # Process Markdown
  45. twig: false # Process Twig
  46. twig_first: false # Process Twig before markdown when processing both on a page
  47. never_cache_twig: false # Only cache content, never cache twig processed in content (incompatible with `twig_first: true`)
  48. events:
  49. page: true # Enable page level events
  50. twig: true # Enable Twig level events
  51. markdown:
  52. extra: false # Enable support for Markdown Extra support (GFM by default)
  53. auto_line_breaks: false # Enable automatic line breaks
  54. auto_url_links: false # Enable automatic HTML links
  55. escape_markup: false # Escape markup tags into entities
  56. special_chars: # List of special characters to automatically convert to entities
  57. '>': 'gt'
  58. '<': 'lt'
  59. valid_link_attributes: # Valid attributes to pass through via markdown links
  60. - rel
  61. - target
  62. - id
  63. - class
  64. - classes
  65. types: [html,htm,xml,txt,json,rss,atom] # list of valid page types
  66. append_url_extension: '' # Append page's extension in Page urls (e.g. '.html' results in /path/page.html)
  67. expires: 604800 # Page expires time in seconds (604800 seconds = 7 days)
  68. cache_control: # Can be blank for no setting, or a valid `cache-control` text value
  69. last_modified: false # Set the last modified date header based on file modification timestamp
  70. etag: false # Set the etag header tag
  71. vary_accept_encoding: false # Add `Vary: Accept-Encoding` header
  72. redirect_default_route: false # Automatically redirect to a page's default route
  73. redirect_default_code: 302 # Default code to use for redirects
  74. redirect_trailing_slash: true # Handle automatically or 302 redirect a trailing / URL
  75. ignore_files: [.DS_Store] # Files to ignore in Pages
  76. ignore_folders: [.git, .idea] # Folders to ignore in Pages
  77. ignore_hidden: true # Ignore all Hidden files and folders
  78. hide_empty_folders: false # If folder has no .md file, should it be hidden
  79. url_taxonomy_filters: true # Enable auto-magic URL-based taxonomy filters for page collections
  80. frontmatter:
  81. process_twig: false # Should the frontmatter be processed to replace Twig variables?
  82. ignore_fields: ['form','forms'] # Fields that might contain Twig variables and should not be processed
  83. cache:
  84. enabled: true # Set to true to enable caching
  85. check:
  86. method: file # Method to check for updates in pages: file|folder|hash|none
  87. driver: auto # One of: auto|file|apcu|memcache|wincache
  88. prefix: 'g' # Cache prefix string (prevents cache conflicts)
  89. purge_at: '0 4 * * *' # How often to purge old file cache (using new scheduler)
  90. clear_at: '0 3 * * *' # How often to clear cache (using new scheduler)
  91. clear_job_type: 'standard' # Type to clear when processing the scheduled clear job `standard`|`all`
  92. clear_images_by_default: true # By default grav will include processed images in cache clear, this can be disabled
  93. cli_compatibility: false # Ensures only non-volatile drivers are used (file, redis, memcache, etc.)
  94. lifetime: 604800 # Lifetime of cached data in seconds (0 = infinite)
  95. gzip: false # GZip compress the page output
  96. allow_webserver_gzip: false # If true, `content-encoding: identity` but connection isn't closed before `onShutDown()` event
  97. redis:
  98. socket: false # Path to redis unix socket (e.g. /var/run/redis/redis.sock), false = use server and port to connect
  99. twig:
  100. cache: true # Set to true to enable Twig caching
  101. debug: true # Enable Twig debug
  102. auto_reload: true # Refresh cache on changes
  103. autoescape: false # Autoescape Twig vars (DEPRECATED, always enabled in strict mode)
  104. undefined_functions: true # Allow undefined functions
  105. undefined_filters: true # Allow undefined filters
  106. umask_fix: false # By default Twig creates cached files as 755, fix switches this to 775
  107. assets: # Configuration for Assets Manager (JS, CSS)
  108. css_pipeline: false # The CSS pipeline is the unification of multiple CSS resources into one file
  109. css_pipeline_include_externals: true # Include external URLs in the pipeline by default
  110. css_pipeline_before_excludes: true # Render the pipeline before any excluded files
  111. css_minify: true # Minify the CSS during pipelining
  112. css_minify_windows: false # Minify Override for Windows platforms. False by default due to ThreadStackSize
  113. css_rewrite: true # Rewrite any CSS relative URLs during pipelining
  114. js_pipeline: false # The JS pipeline is the unification of multiple JS resources into one file
  115. js_pipeline_include_externals: true # Include external URLs in the pipeline by default
  116. js_pipeline_before_excludes: true # Render the pipeline before any excluded files
  117. js_minify: true # Minify the JS during pipelining
  118. enable_asset_timestamp: false # Enable asset timestamps
  119. collections:
  120. jquery: system://assets/jquery/jquery-2.x.min.js
  121. errors:
  122. display: 0 # Display either (1) Full backtrace | (0) Simple Error | (-1) System Error
  123. log: true # Log errors to /logs folder
  124. log:
  125. handler: file # Log handler. Currently supported: file | syslog
  126. syslog:
  127. facility: local6 # Syslog facilities output
  128. debugger:
  129. enabled: false # Enable Grav debugger and following settings
  130. shutdown:
  131. close_connection: true # Close the connection before calling onShutdown(). false for debugging
  132. images:
  133. default_image_quality: 85 # Default image quality to use when resampling images (85%)
  134. cache_all: false # Cache all image by default
  135. cache_perms: '0755' # MUST BE IN QUOTES!! Default cache folder perms. Usually '0755' or '0775'
  136. debug: false # Show an overlay over images indicating the pixel depth of the image when working with retina for example
  137. auto_fix_orientation: false # Automatically fix the image orientation based on the Exif data
  138. seofriendly: false # SEO-friendly processed image names
  139. media:
  140. enable_media_timestamp: false # Enable media timestamps
  141. unsupported_inline_types: [] # Array of supported media types to try to display inline
  142. allowed_fallback_types: [] # Array of allowed media types of files found if accessed via Page route
  143. auto_metadata_exif: false # Automatically create metadata files from Exif data where possible
  144. session:
  145. enabled: true # Enable Session support
  146. initialize: true # Initialize session from Grav (if false, plugin needs to start the session)
  147. timeout: 1800 # Timeout in seconds
  148. name: grav-site # Name prefix of the session cookie. Use alphanumeric, dashes or underscores only. Do not use dots in the session name
  149. uniqueness: path # Should sessions be `path` based or `security.salt` based
  150. secure: false # Set session secure. If true, indicates that communication for this cookie must be over an encrypted transmission. Enable this only on sites that run exclusively on HTTPS
  151. httponly: true # Set session HTTP only. If true, indicates that cookies should be used only over HTTP, and JavaScript modification is not allowed.
  152. split: true # Sessions should be independent between site and plugins (such as admin)
  153. path:
  154. gpm:
  155. releases: stable # Set to either 'stable' or 'testing'
  156. proxy_url: # Configure a manual proxy URL for GPM (eg 127.0.0.1:3128)
  157. method: 'auto' # Either 'curl', 'fopen' or 'auto'. 'auto' will try fopen first and if not available cURL
  158. verify_peer: true # Sometimes on some systems (Windows most commonly) GPM is unable to connect because the SSL certificate cannot be verified. Disabling this setting might help.
  159. official_gpm_only: true # By default GPM direct-install will only allow URLs via the official GPM proxy to ensure security
  160. accounts:
  161. type: data # Account type: data or flex
  162. storage: file # Flex storage type: file or folder
  163. strict_mode:
  164. yaml_compat: true # Grav 1.5+: Enables YAML backwards compatibility
  165. twig_compat: true # Grav 1.5+: Enables deprecated Twig autoescape setting (autoescape: false)