| @@ -21,13 +21,127 @@ | ||
| 21 | 21 | // global style |
| 22 | 22 | 'default_container_width' => 1140, |
| 23 | 23 | 'container_padding' => 10, |
| 24 | 24 | 'container_element_gap' => 20, |
| 25 | + // Responsive breakpoint widths (px). Consumed by every CSS generator | |
| 26 | + // and the block editor; see Helper::get_breakpoints(). | |
| 27 | + 'breakpoint_tablet' => 800, | |
| 28 | + 'breakpoint_mobile' => 480, | |
| 29 | + // How breakpoint queries relate: 'cascade' (max-width envelopes — a | |
| 30 | + // Tablet value also applies on Mobile) or 'strict' (exclusive bands). | |
| 31 | + // See Helper::get_breakpoint_mode(). | |
| 32 | + 'breakpoint_mode' => 'cascade', | |
| 33 | + // User-registered extra breakpoints: [ { key, label, width } ]. | |
| 34 | + 'breakpoint_custom' => [], | |
| 25 | 35 | 'enabled_assets_file_generation' => false, |
| 26 | 36 | 'enabled_block_copy_paste_style' => true, |
| 37 | + // Design system lock: authors may only use the global typography / | |
| 38 | + // colour presets, so nobody can hand-pick a one-off value by mistake. | |
| 39 | + 'lock_global_typography' => false, | |
| 40 | + // Escalates the typography lock from 'no picking a typeface' to 'no | |
| 41 | + // custom typography at all'. Off by default: adjusting a size is normal | |
| 42 | + // design work, picking a stray typeface is the mistake. | |
| 43 | + 'lock_global_typography_strict' => false, | |
| 44 | + 'lock_global_colors' => false, | |
| 27 | 45 | 'enabled_load_google_font_locally' => false, |
| 28 | 46 | 'enabled_only_selected_fonts' => false, |
| 29 | 47 | 'selected_fonts' => [], |
| 48 | + // Emit a metric-adjusted local fallback face per font, so text does not | |
| 49 | + // reflow when the web font finishes loading (CLS). | |
| 50 | + 'font_metric_fallback' => true, | |
| 51 | + // Performance Suite — platform optimizations (opt-in; default off so | |
| 52 | + // existing sites are unchanged until the user enables them). | |
| 53 | + 'perf_disable_emojis' => false, | |
| 54 | + 'perf_disable_embeds' => false, | |
| 55 | + 'perf_disable_dashicons' => false, | |
| 56 | + 'perf_disable_jquery_migrate' => false, | |
| 57 | + 'perf_control_heartbeat' => false, | |
| 58 | + 'perf_heartbeat_frequency' => 60, | |
| 59 | + // Performance Suite — delay JS until interaction. | |
| 60 | + 'perf_delay_js' => false, | |
| 61 | + 'perf_delay_js_timeout' => 5000, | |
| 62 | + // Performance Suite — image loading (safe: on by default). | |
| 63 | + 'perf_lazy_images' => true, | |
| 64 | + 'perf_lcp_eager_count' => 1, | |
| 65 | + 'perf_image_dimensions' => true, | |
| 66 | + 'perf_responsive_images' => true, | |
| 67 | + 'perf_preload_lcp' => true, | |
| 68 | + 'perf_touch_targets' => false, | |
| 69 | + // Performance Suite — inline small page CSS (safe: on by default). | |
| 70 | + 'perf_inline_css' => true, | |
| 71 | + 'perf_async_css' => false, | |
| 72 | + 'perf_critical_css' => false, | |
| 73 | + 'perf_defer_js' => false, | |
| 74 | + // Editor — turn a document pasted from Google Docs into aBlocks blocks | |
| 75 | + // and take its images into the media library as WebP. | |
| 76 | + 'paste_google_docs' => true, | |
| 77 | + 'paste_convert_webp' => true, | |
| 78 | + 'paste_webp_quality' => 92, | |
| 79 | + // Performance Suite — full-page HTML cache. Off by default: unlike | |
| 80 | + // the toggles above it changes what every visitor receives, so it | |
| 81 | + // needs a deliberate decision rather than inheriting a default. | |
| 82 | + // See docs/PAGE-CACHE-PLAN.md. | |
| 83 | + 'perf_page_cache' => false, | |
| 84 | + // 'all' | 'ablocks_only' | |
| 85 | + 'perf_page_cache_scope' => 'all', | |
| 86 | + // Hours; 0 = keep until something invalidates it. | |
| 87 | + 'perf_page_cache_ttl' => 0, | |
| 88 | + 'perf_page_cache_gzip' => true, | |
| 89 | + 'perf_page_cache_prewarm' => true, | |
| 90 | + 'perf_page_cache_mobile_variant' => false, | |
| 91 | + // Empty allowlist means any query string bypasses the cache, so | |
| 92 | + // ?utm_source=x can never overwrite the canonical entry for a URL. | |
| 93 | + // Background crawler: tops the cache up with pages no visitor has | |
| 94 | + // requested yet, a small batch at a time. | |
| 95 | + 'perf_page_cache_crawler' => false, | |
| 96 | + 'perf_page_cache_crawl_batch' => 20, | |
| 97 | + 'perf_page_cache_query_args' => [], | |
| 98 | + 'perf_page_cache_exclusions' => [], | |
| 99 | + // Performance Suite — move render-blocking inline CSS into cached | |
| 100 | + // files so the browser can reuse it across navigations. Off by | |
| 101 | + // default: it changes how every page's CSS is delivered. | |
| 102 | + 'perf_consolidate_css' => false, | |
| 103 | + // Runs smaller than this stay inline — below a couple of KB the | |
| 104 | + // extra request costs more than the bytes saved. | |
| 105 | + 'perf_consolidate_css_min' => 2048, | |
| 106 | + // Performance Suite — cache rendered FSE template parts (header, | |
| 107 | + // footer). Off by default: replaying a cached render's side effects | |
| 108 | + // is the delicate part, so it wants per-site verification. | |
| 109 | + 'perf_fragment_cache' => false, | |
| 110 | + 'perf_fragment_cache_ttl' => 43200, | |
| 111 | + // Performance Suite — memoise block template resolution. Measured at | |
| 112 | + // 11-14ms and 7-10 queries per request on a block theme. | |
| 113 | + 'perf_template_cache' => false, | |
| 114 | + 'perf_template_cache_ttl' => 43200, | |
| 115 | + // Image tools — recompress files on disk. Every part opt-in: unlike | |
| 116 | + // the delivery options above, these rewrite the user's media. | |
| 117 | + 'perf_image_optimize_on_upload' => false, | |
| 118 | + // '1x' gentle | '2x' balanced | '5x' aggressive | |
| 119 | + 'perf_image_level' => '2x', | |
| 120 | + 'perf_image_webp' => true, | |
| 121 | + 'perf_image_quarantine_autodelete' => false, | |
| 122 | + 'perf_image_quarantine_days' => 30, | |
| 123 | + // Upload standards. Filenames can be blocked outright; alt text cannot | |
| 124 | + // be required at upload time, so it gates use instead. See UploadGuard. | |
| 125 | + 'perf_image_require_filename' => false, | |
| 126 | + 'perf_image_require_alt' => false, | |
| 127 | + // Marketing — carry incoming affiliate/UTM query params onto tagged | |
| 128 | + // links so a visitor who lands on ?ref=xyz keeps that param as they | |
| 129 | + // click through. Opt-in; inert unless a tagged link is present AND a | |
| 130 | + // tracked param exists in the current URL. | |
| 131 | + 'param_passthrough_enabled' => false, | |
| 132 | + 'param_passthrough_keys' => 'ref,utm_source,utm_medium,utm_campaign,utm_term,utm_content', | |
| 133 | + // Which links receive the params: 'class' (only links tagged with the | |
| 134 | + // CSS class), 'all' (every same-site link), or 'keyword' (links whose | |
| 135 | + // URL contains one of the configured words). | |
| 136 | + 'param_passthrough_match' => 'class', | |
| 137 | + 'param_passthrough_class' => 'aff-link', | |
| 138 | + 'param_passthrough_keyword' => '', | |
| 139 | + // Remember the incoming params in a cookie so they keep being applied | |
| 140 | + // even after the visitor lands on a page whose URL no longer carries | |
| 141 | + // them (e.g. after clicking an untagged menu link). | |
| 142 | + 'param_passthrough_persist' => true, | |
| 143 | + 'param_passthrough_cookie_days' => 30, | |
| 30 | 144 | 'enabled_coming_soon_page' => false, |
| 31 | 145 | 'coming_soon_page' => '', |
| 32 | 146 | 'enabled_maintenance_page' => false, |
| 33 | 147 | 'maintenance_page' => '', |
