Author: Fakhri Azzouz

  • الربطُ أم الارتباطات؟ رحلة تعريب‏

    الربطُ أم الارتباطات؟.. رحلةٌ في تعريب مصطلح “Bindings” داخل ووردبريس

    أثناء عملي اليومي على تعريب نظام ووردبريس، وتحديداً في أثناء مراجعة ملفات ترجمة إحدى الإضافات المتعلقة بالتكامل مع الخدمات السحابية، وقفتُ أمام سؤال وجّهه إليّ أحد المطوّرين، بدا في ظاهره بسيطاً، لكنه حمل في طيّاته إشكاليةً لغويةً تقنيةً عميقة، إذ قال: “ما رأيكَ بـ ‘الارتباطات’ ترجمةً لمصطلح ‘Bindings’؟”

    ابتسمتُ في نفسي، لأن هذا السؤال تحديداً يُعدّ أحد المزالق التي تسقط فيها الترجمة الآلية، بل وحتى ترجمة المترجمين البشر حين يمرّون على النصوص البرمجية من دون تثبّت. والحقيقة أن كلمة “الارتباطات” هي ترجمة حرفية للمصطلح في المعجم العام، لكنها في سياق علوم البرمجة تصبح ترجمة خادعة، وذلك لأن “الربط” هنا يُعبّر عن فعلٍ أو عمليةٍ (Process) تربط بين عنصرين برمجيين؛ كربط دالة بمتغيّر، أو ربط مصدر بيانات بعنصر تحكّم في الواجهة. في حين أن “الارتباط” يحمل في دلالته معنى العلاقة المجرّدة أو الصلة المنطقية، وهو ما لا يعبّر عن الآلية التقنية التي تجري خلف الكواليس.

    وسرعان ما تلاه سؤال آخر، قال فيه: “حسناً، فما هو جمع ‘ربط’؟”. كان جوابي المباشر أن الجمع الصرفي الأقرب هو “رُبُوط”، غير أنني تريّثتُ قليلاً عند هذه النقطة، وتساءلتُ: هل يصحّ لي أن أكتب هذه الكلمة في واجهة مستخدم ووردبريس؟ تخيّل معي مدير موقع غير مختصّ تقنياً يقرأ جملة من قبيل: “تم حذف الربوط”! سيبدو الأمر غريباً على مسامعه، بل قد يظنّ أن هناك خطأً نحواً، أو أن الكلمة مقحمة من لهجة لا تتناسب مع النصّ الرسمي للنظام.

    وهنا تحديداً تبرز حِرفَة المختصّ في مجال التوطين، تلك التي تتجاوز الترجمة الحرفية إلى هندسة النصّ وفق مقاييس الاستخدام الواقعي.


    لماذا اخترتُ صياغة “عمليات الربط” وتجنّبتُ “ربوط”؟

    في جميع الترجمات التي أقدّمها لعملاء ووردبريس؛ سواءٌ كانوا مطوّرين أو أصحاب مواقع، أعتمد وبشكل ثابت صياغة “عمليات الربط” (عمليات + ربط) كمرادف جمعي للمصطلح. وهذا الخيار لم يأتِ جزافاً، بل استند إلى مجموعة من المبررات العملية واللغوية:

    1. الوضوح بالنسبة إلى المستخدم النهائي: إن إضافة كلمة “عمليات” تمنح المستخدم انطباعاً فورياً بأن هناك إجراءاتٍ تقنيةً تُنفَّذ في الخلفية. فعندما يقرأ مدير الموقع عبارة “جميع عمليات الربط”، فإنه يدرك أنّ الأمر يتعلّق بتكوينات أو مهام تقنية قابلة للحذف أو التعديل، لا أنّه بصدد “علاقات” غامضة بين الجداول.
    2. الانسجام مع المنهجية المُتّبعة في تعريب كبريات الشركات: إذا راجعتَ ترجمات كل من مايكروسوفت وأبل، أو حتى المشروع العالمي لتعريب ووردبريس نفسه، ستجدهم يُفضّلون صياغة المصادر التي تعبّر عن العمليات بهذا الأسلوب؛ فيقولون “معالجة البيانات” لا “بيانات”، و”عمليات التحديث” لا “تحديثات”، وذلك للحدّ من الالتباس وجعل النصّ أكثر احترافية.
    3. تجنّب الخلط القاتل مع مصطلحات أخرى: فلو اعتمدنا “الارتباطات” ترجمةً للمصطلح، لدخلنا في متاهةٍ من الالتباس لا تنتهي، وذلك لأنّ مستخدمي الويب بشكلٍ عام، وأصحاب مواقع ووردبريس بشكلٍ خاص، ألفوا كلمة “رابط” و”روابط” للدلالة على عناوين الصفحات والوصلات التشعبية (URLs). لذا، حين يقرأ مدير الموقع عبارة “تم حذف الارتباطات”، لن يخطر بباله أنّ الأمر يتعلق بعمليات ربط برمجية، بل سيفزع معتقداً أن الروابط الدائمة لموقعه أو وصلات التنقل الداخلية قد انقطعت أو أُزيلت! إنّ استخدام “عمليات الربط” يزيح كل هذا الغموض دفعةً واحدة، ويُبقي النصّ في إطاره التقني المحايد الواضح.

    تطبيق عملي: جملة صغيرة لكنها كبيرة

    في الأسبوع الماضي، بينما كنتُ أترجم رسالة تأكيد لإحدى الإضافات المتكاملة مع جداول بيانات جوجل، كان النصّ الإنجليزي كالتالي:

    “All bindings removed. Your Google Sheets are untouched.”

    كانت الترجمة الآلية السريعة ستعطي نتيجةً حرفية، مثل: “تمت إزالة جميع الربوط. جداول بيانات جوجل الخاصة بك لم تُلمَس”. ولكنني خرجتُ بالصياغة التالية، التي أرسلتها إلى العميل واعتمدها بعد مناقشة قصيرة:

    “تمت إزالة جميع عمليات الربط. ولم تتأثر جداول بيانات جوجل الخاصة بك.”

    ودعني أوضح لك أسباب اختياري لكلّ لفظة هنا:

    • “جميع عمليات الربط” بدلاً من “الربوط”: لأن المستخدم يرى في لوحة التحكّم قائمةً بهذه العمليات، وحذفها يعني حذف إعداداتها وتفكيك تكويناتها، لا حذف “كيانات” مادّية. وهذه الصياغة أشدّ أُنساً للنفس، وأكثر وضوحاً للفهم من الجمع المباشر.
    • “لم تتأثر” بدلاً من “لم تُلمَس” أو “سليمة”: لأن الفعل “تأثّر” هو الأقرب للتعبير الدارج في الرسائل النظامية الاحترافية. تخيّل رسالة من تطبيق بنكي تقول “حسابك لم يتأثر”، فهي أكثر طمأنةً واحترافية من عبارة “حسابك سليم” التي قد تحمل بعض الغموض.

    كلمة أخيرة إلى الزملاء المختصين

    التوطين في ووردبريس ليس مجرد استبدال كلمات من لغة إلى أخرى، بل هو هندسةٌ للنصّ، وغربلةٌ للكلمات بحيث يشعر المستخدم العربي بأن الواجهة صُنعت من أجله هو، لا أنها مجرّد شاشة عولمت بطريقة آلية. أنصح نفسي وإيّاكم باختبار الترجمات على مستخدمين حقيقيين، وألّا نتردّد في طرح السؤال الأهم: لو كنتُ مدير موقع لا يعرف الإنجليزية، فهل ستفيدني هذه الرسالة وتطمئنني؟

    شخصياً، تجنّبتُ استخدام “ربوط” في جميع مشاريعي الأخيرة، ونصيحتي لكم هي الاعتماد على “عمليات الربط” أو “إعدادات الربط” بحسب السياق، والابتعاد تماماً عن “الارتباطات” في النصوص البرمجية الحاسوبية. فلنثق بحاسة السمع العربية أكثر من ثقتنا بالمعجم وحده، فالمتلقّي العربي يسمع الكلمة ويحسّ بوقعها قبل أن يُمعن في تحليلها النحوي.

    وختاماً، أدعوكم لمشاركتي تجاربكم: هل واجهتم مواقف مشابهة مع مصطلحات برمجية أخرى؟ وما هي ترجمتكم المفضّلة لمصطلح “Binding” في مشاريعكم التوطينية؟

  • Code as Context for l10n

    Why WordPress Demands “مخطّط المستند” Over Legacy Translations

    In software localization, a string in isolation is a trap. When translating a massive platform like WordPress, looking at a spreadsheet of isolated English phrases often leads to “safe” but clunky translations. The ultimate source of truth is never the glossary—it is the source code.

    For years, the Arabic localization for “Document Outline” has been ملخص عناوين المستند (literally: Summary of document headings). Born from an era where translators felt the need to heavily explain UI features to users (a process called explicitation), this string is wordy, descriptive, and ultimately outdated.

    As we look toward modern WordPress UI paradigms, it is time to standardize this string to مخطّط المستند. To understand exactly why this update is necessary, we don’t need to debate linguistics—we just need to look at the code.

    The Reference Code: A Window into the UI

    Let’s examine the exact file where this string lives in the Gutenberg block editor: wp-includes/js/dist/editor.js, specifically within the TableOfContentsPanel component.

    Here is the structural blueprint of that panel:

    JavaScript

    // ... [Lines 49560 - 49617 omitted for brevity] ...
    <div className="table-of-contents__wrapper" role="note" aria-label={__("Document Statistics")}>
        {/* Renders Counts: Words, Characters, Time to read, Headings, Paragraphs, Blocks */}
    </div>
    
    { headingCount > 0 && (
        <>
            <hr />
            <h2 className="table-of-contents__title">{__("Document Outline")}</h2>
            <DocumentOutline
                onSelect={onRequestClose}
                hasOutlineItemsDisabled={hasOutlineItemsDisabled}
            />
        </>
    )}
    // ... [Line 49630] ...
    

    By reading this snippet, the context transforms the way we must approach the translation. Here is how the reference code guides us to a vastly superior Arabic localization.

    1. The Code Proves It’s a Structure, Not a “Summary”

    Look at the logic in the code. The panel is divided into two distinct sections. The top half is strictly for Document Statistics (Words, Characters, reading time). This top section acts as the actual summary of the document’s contents.

    Below the <hr /> (horizontal rule), we see the Document Outline. If we keep the legacy translation ملخص عناوين المستند (Summary of headings), we create a semantic clash. We are placing a “summary” directly underneath actual statistical summaries.

    The <DocumentOutline/> component rendered here is a navigational tree—a structural skeleton that lets users jump between header blocks. مخطّط means “plan,” “map,” or “outline.” By using مخطّط المستند, we accurately tell the user they are looking at a structural map, differentiating it cleanly from the statistics above it.

    2. The Original File Path Reveals Architectural Intent While the bundled distribution code lives in editor.js, line 49560 provides a crucial breadcrumb to the original, uncompiled source code: // packages/editor/build-module/components/table-of-contents/panel.mjs.

    This file path is a L10n goldmine. It explicitly identifies that this UI element belongs to the table-of-contents component. A Table of Contents is inherently a navigational map of a document’s hierarchy; it is never a summary of the text itself. By organizing the code under table-of-contents, the core engineering team is signaling clear structural intent.

    Translating this feature as a ملخص (summary) directly contradicts the architectural blueprint of the software. Conversely, مخطّط (outline/map) perfectly echoes the navigational purpose of a Table of Contents, ensuring the Arabic string aligns with the foundational logic of the Gutenberg editor.

    3. The <h2> Tag Demands Brevity

    Notice the HTML element wrapping our string:

    <h2 className="table-of-contents__title">{__("Document Outline")}</h2>

    This string is not explanatory text; it is a section heading (<h2>). In UI design, headings must be punchy, scannable, and instantly recognizable.

    • Legacy: ملخص عناوين المستند (3 words, visually heavy)
    • Proposed: مخطّط المستند (2 words, crisp and standard)

    Users do not read software interfaces; they scan them. A three-word, overly descriptive heading slows down the user’s cognitive parsing. مخطّط المستند functions perfectly as a quick, scannable title.

    4. Spatial Constraints of the Sidebar Panel

    The component name is TableOfContentsPanel. In the WordPress editor, this panel is a narrow sidebar or a popover menu. UI real estate is highly restricted.

    When a multi-word string like ملخص عناوين المستند is crammed into a narrow sidebar, it risks truncation (e.g., ملخص عناوين ا...) or awkward line breaks, especially on mobile views. The source code reveals the physical constraints of the UI, proving that the shorter, more compact مخطّط المستند is a functional necessity to preserve the design layout.

    5. Aligning with Industry Standards

    As localization specialists, consistency across the digital ecosystem is one of our primary goals. When users switch between Microsoft Word, Google Docs, Apple Pages, and various web-based CMS platforms, they shouldn’t have to learn a new vocabulary for the exact same tool.

    Major tech giants have already recognized the need for concise, structural terminology:

    • Google Docs currently utilizes مخطّط المستند for its outline feature.
    • Microsoft Word uses similar structural terminology, like جزء التنقل (Navigation Pane) or مخطط المستند (Document Map in older versions).

    By updating to مخطّط المستند, we align our product with the established mental models of millions of Arab users. We stop forcing them to translate our unique legacy jargon and instead speak the language they already know.

    Conclusion: Translating for the Future

    WordPress is a constantly evolving ecosystem. With modern iterations of the block editor, the UI is becoming cleaner, faster, and more minimalist. Our Arabic localization must evolve with it.

    Relying on the source code changes a translator from a mere linguist into a UI/UX advocate. The code at editor.js:49618 explicitly tells us that “Document Outline” is a compact, structural heading housed within a narrow panel. By dropping the outdated, hand-holding explicitation, observing UI boundaries, and adopting the industry standard مخطّط المستند, we respect the developer’s design and ultimately provide a more native, professional experience for the Arab WordPress user.

  • Why Your WordPress Theme Needs wp_get_theme()->get(‘Version’) for Cache Busting

    Decoding wp_get_theme()->get( 'Version' ): A Beginner’s Guide to Constants and the Arrow (->)

    If you are just starting your journey as a WordPress theme developer, opening the functions.php file of a reputable theme can feel like staring at a foreign language. You will likely come across a line that looks something like this:

    define( 'ARFSE_VERSION', wp_get_theme()->get( 'Version' ) );

    At first glance, it’s just a bunch of symbols, parentheses, and an arrow. What does it do? Why is it there? And what on earth is that -> symbol trying to tell you?

    Let’s break down this single line of code piece by piece. By the end of this post, you won’t just understand it—you will want to use it in your own themes.


    Part 1: Unpacking the Basics – define() and Constants

    Let’s start from the outside and work our way in.

    The define() function is a standard PHP function. Its job is to create a global constant. Think of a constant as a labeled box that holds one specific piece of information. Once you put something inside it, you can never change it while the page is loading—it is “set in stone.”

    • Constant Name: ARFSE_VERSION
    • Constant Value: Whatever is returned by wp_get_theme()->get( 'Version' )

    Once this line runs, you can type ARFSE_VERSION anywhere else in your theme (or even in plugins) and it will magically output your theme’s version number.


    Part 2: Where does the version come from? wp_get_theme()

    Now, let’s look at the right side of the equation: wp_get_theme()->get( 'Version' ).

    wp_get_theme() is a built-in WordPress function. When you call it without passing any arguments, it automatically figures out which theme is currently active and returns a special “object” representing that theme.

    But how does WordPress know the version number? It reads the metadata from your theme’s style.css file. If you open your style.css, you will see a header like this at the top:

    /*
     Theme Name: My Awesome Theme
     Version: 1.2.3
     */

    The wp_get_theme() function parses this file header and loads all this data into memory.


    Part 3: The Magical ->get( 'Version' ) Method

    This is where the arrow (->) comes into play.
    Since wp_get_theme() returned a “Theme Object,” we can access its internal functions using the -> symbol. The get() method is specifically designed to retrieve any value from that style.css header.

    By passing the string 'Version' to this method, we are telling WordPress: “Out of all the data you read from the style.css file, please hand me back only the Version number.”

    It returns the string "1.2.3".


    Part 4: Why do developers use this pattern? (The Real Benefits)

    You might be thinking: “Why not just type ‘1.2.3’ directly into my code?”

    Here are the three biggest reasons this pattern is a game-changer:

    1. Cache Busting (The #1 Reason)

    This is the most important benefit. When you enqueue CSS or JavaScript files in WordPress, browsers aggressively cache them to speed up page loading.

    If you hardcode the version as 1.0 and update your theme’s styles, your users will keep seeing the old, cached CSS files.

    By using the constant, you can write your enqueue function like this:

    wp_enqueue_style( 'my-theme-style', get_template_directory_uri() . '/style.css', [], ARFSE_VERSION );

    Now, whenever you bump the version number in your style.css header, the URL automatically changes to style.css?ver=1.2.3. Browsers see this as a “new” file and instantly download the fresh assets. No more clearing caches manually!

    2. Single Source of Truth

    You only maintain the version number in one place—the style.css header, which WordPress requires anyway. Instead of updating the version in five different files, you define the constant once, and the entire theme inherits it automatically.

    3. Conditional Logic for Updates

    You can use the constant to run database migrations or update routines:

    if ( get_option( 'my_theme_db_version' ) !== ARFSE_VERSION ) {
        // Run database upgrade scripts...
        update_option( 'my_theme_db_version', ARFSE_VERSION );
    }

    Part 5: Zooming in on the Arrow (->)

    Now, let’s tackle the part that scares most beginners: the Object Operator, or as it is officially known, the arrow (->).

    The arrow’s entire job is to access a property or method that belongs to a specific object.

    Here is the exact execution order when PHP runs wp_get_theme()->get( 'Version' ):

    1. Step 1: PHP calls wp_get_theme(). This builds a WP_Theme object in memory.
    2. Step 2: PHP looks at the arrow (->) and sees the method get() on the right side.
    3. Step 3: It searches inside that specific WP_Theme object, finds the get method, and runs it.
    4. Step 4: It passes the argument 'Version' into that method and returns the result.

    Method Chaining (A Cool Trick)
    Without the arrow, you would have to write this in two separate lines:

    $theme_object = wp_get_theme();       // Step 1: Get the object
    $version = $theme_object->get( 'Version' ); // Step 2: Access the method

    By using -> right after the function call, PHP allows you to chain them together into one smooth, elegant line.


    Part 6: What is happening inside the get method?

    To truly understand the arrow, you need to know what happens when the method runs. Inside the WP_Theme class, the get() method uses a special PHP variable called $this.

    $this is a pointer that represents the exact object that the arrow was used on.

    A simplified version of the code inside the class looks like this:

    class WP_Theme {
        private $headers = []; // Stores the style.css data
    
        public function get( $header_key ) {
            // $this refers to the object we just grabbed via wp_get_theme()
            if ( isset( $this->headers[ $header_key ] ) ) {
                return $this->headers[ $header_key ];
            }
            return '';
        }
    }

    So when you write $theme_obj->get('Version'), the $this inside the method points right back to $theme_obj, allowing it to read its own internal data.


    Part 7: The Showdown – Arrow (->) vs. Double Colon (::)

    New PHP developers often confuse the arrow (->) with the double colon (::). They are not interchangeable.

    To understand why, you need to know the difference between a Blueprint (Class) and a Physical Building (Instance):

    FeatureInstance (Object) – uses ->Static (Class) – uses ::
    How to createMust use new keyword (e.g., $house = new House();).No new needed. Exists automatically (e.g., House::getBlueprint();).
    MemoryEach object gets its own copy of properties. (House A has a red door, House B has a blue door).Only one copy exists in memory, shared by everything.
    The $this variableAvailable. $this refers to this specific object.Not available. There is no specific object to refer to.
    When to useWhen you have specific data that belongs to one thing (like multiple WP_Query loops).For stateless utilities (like formatting text) or when you don’t need to store unique data.

    Why this matters in our code: wp_get_theme() returns an Instance (an actual object). Therefore, you must use ->. If you tried wp_get_theme()::get('Version'), PHP would throw a fatal error!


    The Curious Bonus: The Fundamental Difference – Instance (Object) vs. Static (Class) Context in PHP

    To fully grasp the arrow (->), you must contrast it with the double colon (::). They are not interchangeable, and the difference comes down to context.

    Think of a Class as a blueprint for a house, and an Instance (Object) as an actual physical house built from that blueprint.

    FeatureInstance (Object) – uses ->Static (Class) – uses ::
    CreationMust use new (e.g., $house = new House();).No new needed. Exists automatically (e.g., House::getBlueprint();).
    MemoryEach object has its own copy of properties. House A has a red door; House B has a blue door.Only one copy exists in memory, shared globally across your entire script.
    The $this variableAvailable. $this refers to this specific object’s unique data.Not available. There is no specific object to point to.
    State managementMaintains state—changes to one object do not affect others.Stateless—changing a static property changes it for everyone using that class.
    Use caseWhen you need to store unique data (e.g., multiple WP_Query objects).For pure utility functions that don’t rely on specific data (e.g., formatting strings).

    Why this matters here: wp_get_theme() returns an Instance (an actual object). Therefore, you must use ->. If you mistakenly tried wp_get_theme()::get('Version'), PHP would throw a fatal error because the :: operator is for static class members, not for objects.


    Final Thoughts: Don’t Fear the Symbols

    When you see wp_get_theme()->get( 'Version' ), don’t see gibberish. See it as:

    • A Powerful Constant that makes your code easier to maintain.
    • A Dynamic Version that busts browser caches automatically.
    • A friendly Arrow (->) acting as a bridge between a function and the specific object it returned.

    The arrow is your best friend in Object-Oriented PHP. It tells the interpreter: “Take the object I just got, look inside it, and run this specific function on it.”

    Keep practicing, keep reading core WordPress code, and soon these patterns will feel like second nature. Happy coding! 🚀

  • Decoding WordPress PHP: Why Do We Use if ( … ) : Instead of {}?

    As I dive deeper into the world of WordPress Full Site Editing (FSE) theme development, I’m spending a lot of time dissecting the default Block Themes—like Twenty Twenty-Five.

    FSE is shifting so much of theme development into theme.json and block markup, but PHP remains the backbone of how our themes actually function. Recently, while looking at the functions.php file in a default theme, I stumbled upon a piece of syntax that always used to confuse me:

    if ( ! function_exists( 'my_theme_setup' ) ) :
        // ... function code here ...
    endif;

    Wait a second. Where are the curly braces {}? Why is there a colon : after the if statement?

    If you’ve ever asked yourself the same questions, you aren’t alone. Today, I want to break down this quirky PHP syntax, explain why WordPress loves it, and discuss whether you should be using it in your own FSE themes.

    The Alternative Syntax Explained

    That colon is part of PHP’s alternative syntax for control structures. It does the exact same thing as the standard curly-brace syntax; it’s just a different way of writing it.

    Here is a side-by-side comparison:

    The Standard Way:

    if ( ! function_exists( 'my_theme_setup' ) ) {
        function my_theme_setup() {
            // Setup code
        }
    }

    The Alternative Way:

    if ( ! function_exists( 'my_theme_setup' ) ) :
        function my_theme_setup() {
            // Setup code
        }
    endif;

    Functionally, these are identical. PHP doesn’t care which one you use. But if they do the same thing, why does WordPress consistently use the colon method?

    The “Why”: Readability in the Trenches

    The primary reason for the alternative syntax is readability when mixing PHP and HTML.

    As theme developers, we are constantly jumping in and out of PHP to output HTML. When you have nested if statements, foreach loops, and while loops all mixed with HTML, a wall of closing curly braces } becomes a nightmare to read. You find yourself scrolling up and down asking, “Which } closes the if statement, and which closes the loop?”

    The alternative syntax solves this by explicitly labeling the closing tag. Consider this classic loop example:

    Using Curly Braces (Hard to read):

    <?php if ( have_posts() ) { ?>
        <div class="post-list">
            <?php while ( have_posts() ) { 
                the_post(); ?>
                <h2><?php the_title(); ?></h2>
            <?php } ?>
        </div>
    <?php } ?>

    Look at the bottom. You have } and }. It’s not immediately obvious what belongs to what.

    Using the Colon Syntax (Much clearer):

    <?php if ( have_posts() ) : ?>
        <div class="post-list">
            <?php while ( have_posts() ) : 
                the_post(); ?>
                <h2><?php the_title(); ?></h2>
            <?php endwhile; ?>
        </div>
    <?php endif; ?>

    Now, the bottom is perfectly clear: endwhile; closes the loop, and endif; closes the condition. It’s a breath of fresh air for readability.

    Why use it in functions.php?

    You might be thinking: “Okay, I get it for HTML templates. But the code snippet I showed at the beginning was from functions.php, which is pure PHP! Why use it there?”

    You caught me! In pure PHP files, the readability benefit of mixing HTML doesn’t apply. However, in WordPress, using the colon syntax for pluggable functions has become a cultural convention.

    The if ( ! function_exists() ) : pattern is how WordPress creates “pluggable” functions. It allows a child theme to define the same function, effectively overriding the parent theme. Because this is such a vital concept in WordPress theme development, using endif; acts as a visual “bookend.” When you are scrolling through hundreds of lines of code in functions.php and see endif;, you instantly know: “Ah, this is the end of a pluggable function override check.”

    Is it Best Practice for FSE Theme Developers?

    This is where nuance comes in. The short answer is: It depends on the file.

    • In PHP Template Files / Block Render Callbacks: YES. Even in FSE, you will write PHP to render dynamic blocks or create custom block patterns via PHP. Whenever you are mixing PHP logic and HTML output, using if : ... endif; and while : ... endwhile; is a WordPress best practice. It is explicitly recommended in the WordPress Coding Standards.
    • In Pure Logic Files (functions.php, Classes): IT’S UP TO YOU. General PHP standards (like PSR-12) actually prefer curly braces {} for pure logic files. However, because WordPress has its own long-standing conventions, you will see the colon syntax used frequently even in functions.php. Neither is “wrong” here.

    The Takeaway

    As FSE theme developers, we are navigating the bridge between classic WordPress PHP conventions and modern block-based development. While theme.json handles most of the visual setup now, understanding why WordPress code looks the way it does empowers us to write cleaner, more maintainable PHP for our dynamic blocks and theme setups.

    The next time you see that colon : in a theme file, you don’t need to be confused. You can just smile, knowing it’s there to make your life a little easier when you’re deep in the code.


    Are you building FSE themes? What PHP quirks have you run into lately? Let’s chat in the comments below!

  • When two words in English become one in Arabic


    When “Optimizations” and “Improvements” Become the Same Word: An Arabic Localization Puzzle

    Imagine you’re translating a changelog for a sleek software product. The release note reads:

    Front-end Optimizations improvements

    As a localization specialist, you pause. In English, “optimizations” and “improvements” carry subtly different weights: one hints at performance tuning, the other at overall quality boosts. But in Arabic, both words often funnel into a single term: تحسينات (tahseenaat).

    Put them together literally, and you get a tongue-twisting redundancy:
    تحسينات تحسينات الواجهة الأمامية
    “Improvements improvements of the front end.” Not exactly the crisp, professional tone your client expects.

    This kind of linguistic collision happens more often than we admit, and how we handle it can make or break the user experience. Let me walk you through my thought process and the solutions I’d offer.


    First, understand the intent

    Before reaching for a thesaurus, I always ask: What is this string really trying to say?
    Does “Front-end Optimizations” refer to a specific named feature, module, or settings tab in the product? Or is it a general description of performance work? The answer steers the translation.

    Here are the three strategies I’d use, depending on the context.

    Option 1: The natural, flowing approach (usually my go-to)

    If the goal is simply to tell users “we made the front end even better,” I merge the concepts gracefully. Instead of forcing two nouns to coexist, I introduce a word like performance or additional to bridge the gap:

    • تحسينات إضافية لأداء الواجهة الأمامية
      Additional improvements to front-end performance
    • المزيد من تحسينات الواجهة الأمامية
      More front-end optimizations

    This reads naturally and avoids the awkward repetition while keeping the message intact.

    Option 2: The exact technical approach

    When “Front-end Optimizations” is the official label of a feature, dashboard card, or settings panel, I can’t just dissolve it. The user might need to locate that exact term in the UI. In that case, I keep the term distinct by using a synonym pair:

    • تطويرات على تحسينات الواجهة الأمامية
      Enhancements to Front-end Optimizations

    Here, تطويرات (tatawweeraat – developments/enhancements) takes the role of “improvements,” while تحسينات stays frozen as the feature name. It’s a bit clunky, but it preserves the technical mapping.

    Option 3: Action-oriented, changelog-style

    Release notes often benefit from a punchy verbal noun at the start. This turns a static label into a dynamic promise:

    • تعزيز تحسينات الواجهة الأمامية
      Boosting Front-end Optimizations

    Short, active, and unmistakable. It treats “Front-end Optimizations” as a noun phrase you’re amplifying, not as a redundant couple.


    The real secret? Always ask for context

    This tiny phrase taught me—again—that even two English words can collapse into one in another language. The fix isn’t a dictionary swap; it’s detective work. Is “Front-end Optimizations” the official name of a specific settings tab in your software, or is it just a general description of the update? The right Arabic translation hangs entirely on that answer.

    Next time you encounter a deceptively simple string like “Optimizations improvements,” take a breath, decode the intent, and choose the strategy that keeps the message clear—and your client’s interface elegant.


    Have you faced a similar localization puzzle where two distinct terms became one in your target language? I’d love to hear how you solved it. Let’s swap war stories in the comments.