Türker Yıldırım

gutenberg

  • A user-edited template overrides the file, permanently

    Note2 min read

    There is no merge and no notification — the database copy wins entirely, and the only signal is a “Customized” label in an editor screen nobody opens. Deleting…

  • Style variations are theme.json fragments in styles/

    Note2 min read

    6.0 in May reads every JSON file in styles/ as an alternative set of settings and styles, merged over the base. The merge is deep, so a variation…

  • Testing a block theme without a browser

    Deep dive10 min read

    A theme with no PHP has nothing a unit test can call, and the only test is a person looking at a page.

  • useBlockProps applies the class the editor expects

    Note2 min read

    API version 2 moves the block wrapper from the editor into the block, which means the editor markup and the front-end markup can finally match. Forgetting the call…

  • A block theme is a directory of HTML files

    Deep dive16 min read

    5.9 on 25 January, and templates/ replaces the template hierarchy. A theme with 41 PHP templates and an editor that cannot see any of them.

  • blockGap, and the margin you stopped writing

    Note2 min read

    Vertical spacing between blocks moves from a stylesheet rule to a setting, which is a better mechanism and a large diff. Setting blockGap to false disables the control…

  • index.html is the only required template

    Note1 min read

    A block theme needs style.css, templates/index.html and nothing else, which makes the minimum viable theme three files. The fallback to index.html is total rather than partial, so a…

  • theme.json v2 renamed the keys you just learned

    Note2 min read

    Version 2 arrives with 5.9, six months after version 1, and moves several keys — a file written in 2021 needs migrating. The customTemplates and templateParts sections are…

  • templates/ and parts/ replace the template hierarchy

    Note2 min read

    5.9 on 25 January makes a theme a directory of HTML files, and the PHP template hierarchy stops being how a page is chosen. The naming still follows…

  • A hybrid theme keeps PHP templates and gains theme.json

    Note2 min read

    A classic theme can add theme.json without becoming a block theme, which is the migration path for an existing site. The flip is abrupt: creating templates/index.html makes WordPress…