Version 1.4.0 is a SEO-focused release: standardized meta/Open Graph/Schema.org output, automatic breadcrumbs and table of contents, a dictionary-based Content Optimizer that replaced an earlier AI-API approach, and a fix for a Turkish slug bug.
jekcms 1.4.0 is a SEO- and content-quality-focused release. Meta tags, Open Graph, Twitter Cards, and Schema.org structured data were reviewed and standardized across the board, and two new on-page features — breadcrumbs and an automatic table of contents — ship for every theme.
Breadcrumb Navigation With Schema.org Markup
Breadcrumb navigation now renders with proper Schema.org BreadcrumbList markup, so search engines can show the breadcrumb trail directly in search results rather than just the raw URL. This applies across the default theme set without any theme-side configuration.
Automatic Table of Contents
A table of contents is now generated automatically from a post's <h2>/<h3> headings — no manual TOC building, no plugin. Depending on the active theme, it renders as a sticky sidebar widget or an inline block near the top of the post. For long-form content, this is a straightforward win for both readability and the "jump to a heading" search-result feature some search engines show.
Content Optimizer: Dictionary-Based, Not AI-Based
The Content Optimizer got rebuilt around a dictionary-based synonym refresh, replacing an earlier approach that called an external AI API (Gemini/Groq) to suggest word variations. That approach broke Turkish morphology often enough — word forms that don't inflect the way the AI assumed — that it was worth replacing with something deterministic. The new dictionaries cover roughly 200 modern Turkish word pairs and roughly 180 English pairs, with archaic or overly formal terms deliberately left out. Language selection for the optimizer is driven by your site's ai_content_language setting, so it picks the right dictionary automatically rather than needing per-post configuration.
A Small but Real Google SERP Fix
The site name shown in Google search results and in og:site_name/WebSite schema had a subtle bug: a ?? null-coalescing check doesn't catch an empty string, only an actually-unset value, so a site name that was set to "" somewhere upstream would silently fall through instead of using the configured default. That check was changed to ?:, which does catch empty strings. A new <meta name="application-name"> tag was also added to every theme header, which is one of the additional signals Google can use to determine your site's display name in search results.
Turkish Slug Generation Fix
generateSlug() now correctly transliterates ç, ğ, ı, ö, ş, and ü across every site, instead of occasionally dropping or mangling them. For installs that already had posts with corrupted Turkish slugs from before this fix, a fix-slugs.php utility script is available to repair them in place without changing the post content itself.
What This Means If You're Upgrading
None of the 1.4.0 changes above require you to touch your theme code or your content — the SEO/schema standardization, breadcrumbs, and table of contents apply automatically once you update. The one thing worth doing manually: if your site publishes in Turkish and might have slugs generated before this release, run fix-slugs.php once after upgrading to catch anything that slipped through with the old transliteration bug.
