Changeset 3749853 for translate/trunk/Components/SwitcherPlacement.php

Timestamp:

10/16/2026 07:26:04 AM (3 weeks ago)

Author:

codesnippetspro

Message:

Version v0.10.28

File:

• translate/trunk/Components/SwitcherPlacement.php (modified) (3 diffs)

translate/trunk/Components/SwitcherPlacement.php

@@ -4 +4 @@
 
 /**
- * Where the switcher sits inside the document when it is placed inline: a
- * suggested zone, or an unrestricted anchor (a CSS path plus a position
- * relative to it). Stored as a reproducible description, never as viewport
- * coordinates, so it survives across page loads. A page placement wins over
- * the site-wide one while it exists.
+ * Where the switcher sits inside the document when it is placed inline: an
+ * anchor, a CSS path plus the side of that element the switcher sits on.
+ * Stored as a reproducible description, never as viewport coordinates, so it
+ * survives across page loads. A page placement wins over the site-wide one
+ * while it exists. Zones and the prepend and append positions are read for
+ * placements stored by earlier versions.
  */
 class SwitcherPlacement {
@@ -16 +17 @@
         public const ZONES = [ 'header', 'before_content', 'after_content', 'sidebar', 'footer' ];
 
-        public const ANCHOR_POSITIONS = [ 'before', 'after', 'prepend', 'append' ];
+        public const ANCHOR_POSITIONS = [ 'before', 'after', 'left', 'right', 'prepend', 'append' ];
+
+        public const ANCHOR_FALLBACKS = [ 'floating', 'none' ];
+
+        public const ANCHOR_FALLBACK_KEY = 'anchor_fallback';
 
         private const MAX_SELECTOR_LENGTH = 1024;
@@ -74 +79 @@
         }
 
+        /** What a page shows when the stored anchor matches none of its elements. */
+        public static function anchor_fallback(): string {
+                $switcher = Options::get( 'languages.switcher', [] );
+                $value    = is_array( $switcher ) ? sanitize_key( (string) ( $switcher[ self::ANCHOR_FALLBACK_KEY ] ?? '' ) ) : '';
+
+                return in_array( $value, self::ANCHOR_FALLBACKS, true ) ? $value : 'floating';
+        }
+
+        public static function save_anchor_fallback( string $value ): void {
+                $value = sanitize_key( $value );
+                if ( ! in_array( $value, self::ANCHOR_FALLBACKS, true ) ) {
+                        return;
+                }
+                $switcher = Options::get( 'languages.switcher', [] );
+                $switcher = is_array( $switcher ) ? $switcher : [];
+                $switcher[ self::ANCHOR_FALLBACK_KEY ] = $value;
+                Options::update( 'languages.switcher', $switcher );
+        }
+
         public static function page_placement( int $post_id ): ?array {
                 if ( $post_id <= 0 ) {