All notable changes to the Kinetix theme and its companion plugins. Versions follow the roadmap in the internal roadmap (v1.0.0 to v3.2.9).
Unreleased
Changed
- Buyer guide: the Enterprise feature is now called “White-label agency mode” throughout, as on the licence screen (docs only).
[3.5.0] - 2026-11-14
feat(release): v3.5.0: full white-label, WordPress.org preparation, yearly-only licence wording
Changed
- Full white-label (Scholar & SEO Pro Enterprise): existing Enterprise sites with a saved brand name become fully rebranded on update (admin, Plugins and Themes screens, Customizer, block editor, login screen), not only Appearance > Kinetix. Empty the brand name in the White-label panel to keep Kinetix. See .
- WordPress.org preparation: Theme URI
https://kinetix.software, Author URIhttps://istiakahamed.com, Plugin URI and Author URI on all three plugins,Contributors: istiakahamedofficialin the theme and Kinetix Core readmes, and a help pointer to the WordPress.org support forum in both free readmes. - Buyer-facing words follow Istiak’s answers of 14 Nov 2026: yearly licences only (no monthly plan; the licence comparison table now says “$49 a year”), Scholar & SEO Pro sold on its own or in the bundle, multi-domain packs, expiry keeps features and stops updates, support and new Pro templates, buyers move a key by deactivating on the old site and activating on the new one, and support at support@kinetix.software (paid-plugin readmes, user guide, Scholar Priority support widget text). No licence code changed.
Added
- : checklist for submitting the free theme and Kinetix Core to WordPress.org.
[3.4.0] - 2026-11-14
feat(release): v3.4.0: leads in admin, Scholar import and publication lists, starter images, CSS and font clean-up
Added
-
Scholar & SEO Pro: Import by ORCID iD on Research > Import publications, through OpenAlex (
api.openalex.org, CC0 data, no key; ORCID’s own Public API is not used because its terms bar products that are sold). The iD’s format and ISO 7064 check character are verified first; the author’s works are read 100 at a time with cursor paging (most cited first, at most 500) and go through the same cleaning, duplicate check and drafts-by-default path as BibTeX. Onlyapi.openalex.orgover https is contacted (wp_safe_remote_get, no redirects, 10 s timeout, 15 s budget), only when the form is sent; HTTP 429 or any failed request stops the import before a paper is created. Complete results are cached for 15 minutes. No email or API key is sent unless thekinetix_sp_openalex_mailto/kinetix_sp_openalex_api_keyfilters supply one. -
Scholar & SEO Pro: Research > Import publications creates papers from a BibTeX file (up to 1 MB) or pasted BibTeX, the format reference managers and Google Scholar export. Drafts by default; papers already on the site are skipped (same DOI in any letter case, else same title and year). LaTeX accents, @string macros, ”#” joins and “Last, First” names are read; broken entries are skipped and counted. Administrators only, nonce-checked, licence-gated; every imported field is reduced to plain text or an http(s) URL. Malformed files cannot exhaust the server: @string expansion is capped (64 KB per value, 1 MB in all) and parsing stops at the first entry that never closes.
-
Scholar & SEO Pro: publication types (journal article, conference paper, preprint, thesis, book, book chapter, dataset, software) in a new sidebar box, used by the BibTeX (
@inproceedings,@phdthesis, …) and RIS (CPAPER,THES, …) downloads. Not set keeps the old article/misc and JOUR/GEN output. The box also stores a year or year-month for papers without an exact date. -
Scholar & SEO Pro: the DOI lookup now also fills in DataCite DOIs (arXiv, Zenodo, datasets, software):
data.crosscite.organdapi.datacite.orgjoin doi.org and Crossref as the only hosts it contacts. Year-only dates and the publication type are filled in too. -
Scholar & SEO Pro: Publication list block and
[kinetix_publications]shortcode. Published papers as citations in APA (7th), MLA (9th), Chicago (17th, bibliography) or IEEE, grouped by year or type, with DOI, PDF, BibTeX and RIS links, visitor filters (type, year, research area) and one BibTeX download for the whole filtered list (unique cite keys). Drafts, private, scheduled and password-protected papers are never listed. Attributes and visitor filters share one allow-list; at most 100 papers per page and 500 per list; licence-gated. A list’s data is cached for 12 hours and refreshed when a paper is saved, trashed, deleted, changes status or research area. The year filter and the year menu reach papers older than the newest 500; a list that still hits the cap says so. The filter form submits to the current page. -
Scholar & SEO Pro: the
citation_*tags are de-duplicated (one value per single-value tag, each author once) and print once per page, also with Yoast SEO or Rank Math active. SEOPress and The SEO Framework are now detected too, so the plugin’s own graph and social tags stand down for them as they do for Yoast, Rank Math and AIOSEO. -
Kinetix Core: intake form messages are now also stored in the WordPress admin under Leads (name, email, date, read or unread, single view, delete), so a message is not lost when its email never arrives. The email is sent exactly as before. Non-public post type
kinetix_lead, manage_options only, WordPress personal data exporter and eraser, a retention setting (Leads > Settings, default 12 months, 0 keeps them) with a daily purge, and thekinetix_core_store_leadsfilter to turn storing off. -
Kinetix Core: deleting the plugin (not deactivating it) removes the stored leads, the retention setting and the purge schedule (
uninstall.php). -
Latin-extended (
latin-ext) subsets of all six type pairings, self-hosted (OFL). Browsers download them only when a page uses a character in theirunicode-range(for example Polish, Czech or Turkish text). -
Kinetix Core: free sites now see the five Pro starter sites on Appearance > Starter Sites as quiet preview cards (name, description, colours, a Pro label, no import button) under “More designs with Kinetix Pro”. The Pro content stays in Kinetix Interactions Pro. A Get Kinetix Interactions Pro link appears only when the
kinetix_pro_urlfilter returns an http(s) address (empty by default, so no link today). New filterkinetix_core_pro_starter_previews. No admin notices. -
Starter sites now come with images: 4 for Director (in Kinetix Core) and 24 files across the five Pro starters (in Kinetix Interactions Pro), all CC0 photographs from Wikimedia Commons with their credits in each plugin’s
starter-data/images/credits.json. Import copies them from the plugin into the Media Library (nothing is downloaded) and sets them as featured images of posts and projects; project grids and multi-column post grids show them. Remove starter content deletes them with their files unless they were edited or are still used. The validator checks every image exists, stays under 200 KB and has a CC0 or public-domain credits entry.
Fixed
- Starter copy now promises only what imports: the Photographer card no longer mentions a masonry gallery,
lightbox or booking calendar, and its Prints page is now Print enquiries (order by email). The Gamers
card says “merch showcase that takes orders by email” instead of “merch storefront”, its Shop page is now
Merch (same address,
/shop/) and the “Pre-order” buttons read “Order by email”. - Leads in the trash are now also reached by the personal data exporter and eraser and by the retention purge.
- The header glow no longer makes the page wider than a 390 px screen (
.hero-glowis capped at the page width). - Merged duplicate CSS rules left behind by earlier merges (header bar, project list rows, captions, comment labels); rendering is unchanged.
[3.3.0] - 2026-11-12
feat(release): v3.3.0 improvements from the post-release audit
Built on its own branch (feat/v3.3-improvements) so it can be merged or dropped without touching v3.2.9.
Fixed
- “Remove starter content” deletes only starter items nobody edited; edited pages, categories and menus holding the owner’s content are kept and listed; reading settings restored only if unchanged.
- Director demo: “Hello world!” no longer tops the demo after a re-import; footer menus have natural names in all six starters; no real brand or product names in any starter (the validator now rejects them).
- Intake form works on cached pages (fresh signed token), keeps the visitor’s input on every error, rate-limits per visitor (IP + hashed email), sends plain-text mail with a safe Reply-To.
- Without a licence, the slider, marquee and project compare show static, accessible content instead of nothing; an expired licence keeps its features (only updates and support stop); paper DOI/PDF links stay.
- Two-level menus in every header (keyboard-accessible dropdowns) and the mobile drawer.
- Project covers fit phones and tablets; the first vault cover and the project cover load first.
Added
theme.json(classic theme), editor styles that follow the Customizer’s colours and fonts, and 8 Kinetix block patterns.- Self-hosted fonts for all six type pairings (OFL, licences bundled); no requests to Google.
- 159 PHPUnit tests and a GitHub Actions pipeline: PHP 8.1 to 8.5, WordPress Coding Standards + PHPCompatibility, generated-file drift check, Playground smoke tests.
Changed
- Tailwind output minified (44.8 KB to 31 KB);
kinetix-blocks.cssloads only where block styles are used. - Licence tests: 87 to 125.
[3.2.9] - 2026-11-11
chore(release): complete SEO schema audit, responsive overflow lock, PHP lint verification, and CHANGELOG for v3.2.9
Added
- Release tooling:
scripts/build-zip.sh(the four release zips),scripts/wporg-check.sh(Theme Check and Plugin Check in WordPress Playground),scripts/screenshot.sh(exact-size headless screenshots),scripts/phpcs.sh(WordPress Coding Standards + PHPCompatibilityWP 8.1),scripts/make-pot.sh. readme.txtfor the theme and all three plugins; themescreenshot.png(1200 × 900).- Documentation: buyer user guide (, 9 chapters) and codebase guide book (, 13 chapters).
Changed
- Visual QA: content width under the fixed header, light-scheme leftovers, footer text at WCAG AA, split-island click-through, admin-bar offset on phones, scroll padding for anchors.
- Accessibility: AA contrast, visible focus, working pagination, long titles wrap at 390 px, reduced motion; drawer and search dialog trap and restore focus.
- WordPress.org compliance: Theme Check 0 REQUIRED / 0 WARNING; Plugin Check 0 / 0 on Kinetix Core; WordPress Coding Standards across the theme and Kinetix Core.
- Removed
design-reference/static-v1/(the static v1.0.0 site stays onmainand tagv1.0.0).
Security
- REST API no longer exposes the meta of password-protected projects and papers.
- BibTeX export escaping; only published, non-password papers export; DOI lookup restricted to https doi.org / api.crossref.org.
- Starter content uses invented names only; no real companies, people or publications.
Verified
- Smoke tests on PHP 8.5 (Playground’s runtime): full (theme + all plugins), theme-only and starter (import, re-import, remove) modes, zero PHP notices, empty debug.log; PHP 8.1 compatibility checked statically; 87/87 licence tests; starter data validator.
Before release (Istiak)
- Store URL, support contact, licence policies, WordPress.org username (readme Contributors),
Theme URI / Author URI: see
docs/user-guide/README.md“Before publishing”. - Repository renames (Kinetix-Beta, Kinetix-Enterprise) and version tags need repository admin rights.
[3.1.5] - 2026-11-11
feat(licensing): implement Free, Pro, and Enterprise tier gating, SHA-256 validation, and white-label agency mode
Added
- Offline licence keys in both paid plugins: Ed25519-signed payload (tier, domain, expiry, id),
verified with sodium (WordPress’s sodium_compat), bound to the site’s domain (punycode-normalised;
localhost, 127.0.0.1, *.test and *.local allowed for development); the key’s SHA-256 fingerprint
keys the cached verdict (per site on multisite). Pro unlocks Interactions Pro; Enterprise adds
Scholar & SEO Pro (
kinetix_ip_enabled/kinetix_sp_enabled). The free theme and Kinetix Core have no licence code at all. - Settings > Kinetix licence: activate / deactivate, status, Free / Pro / Enterprise comparison with
prices (Pro $49/year or $14/month, Enterprise $199 lifetime), buy link from
kinetix_pro_url. - Enterprise: white-label admin name and logo (
kinetix_admin_brand_*), Priority support dashboard widget with copyable system info. scripts/license/: keygen (refuses paths inside a repository), issue, and 87 automated tests.
Security (review)
- Key files are git-ignored; regression tests cover look-alike dev hosts, padding, tampering and IDN.
[3.0.0] - 2026-11-11
feat(starters): engineer 1-click starter site importer with 6 complete industry templates
Added
- Kinetix Core: Appearance > Starter Sites with one-click AJAX import of theme settings, pages,
posts, projects, research, menus and footer widgets, and a “Remove starter content” action that
deletes only what the import created; the free Director starter site; the
[kinetix_intake_form]project form (nonce, honeypot, mail to the site admin); the starter JSON schema (starter-data/SCHEMA.md). - Theme: ten Kinetix block styles (spotlight, glass, section, stat, eyebrow, display, pill, outline, bento, marquee) in plain CSS, so imported content looks right without Tailwind.
- Kinetix Interactions Pro: five Pro starter sites (Magazine, Gamers, Programmer, Photographer, Real Estate), offered only while Interactions Pro is licensed.
scripts/validate-starters.mjs(checks starter data against the build contract) and the starter generators inscripts/starters/.- Smoke test mode
starter: imports Director, re-imports (idempotent), removes, and checks the nonce-less AJAX call is refused.
[2.6.0] - 2026-11-11
feat(admin-ui): build dedicated Kinetix WP Admin dashboard with hot-swappable logo and option tabs
Added
- Appearance > Kinetix (WordPress.org-compliant, core admin UI): Overview with deep links into the Customizer sections, Starter sites, Plugins (Kinetix Core status with activate / install links) and Help.
- Admin bar menu with the brand logo, linking to the dashboard and Customizer sections
(users with
edit_theme_optionsonly). - Hot-swappable logo: drop
custom-logo.svgor.pngintoassets/images/; filterskinetix_admin_brand_nameandkinetix_admin_brand_logo_url(used by white-label). - Theme
readme.txtwith resource credits (Lucide ISC, Feather MIT, fonts).
[2.3.0] - 2026-11-11
feat(plugins): package Kinetix Interactions Pro and Kinetix Scholar SEO Pro as standalone monetized plugins
Added
- Kinetix Interactions Pro: magnetic cursor, cursor-following light-leak cards (adds the
light-leakcard hover choice), comparison slider and CSS marquee, moved out of the theme; shortcodes[kinetix_slider]and[kinetix_marquee]; raw-to-real slider on projects throughkinetix_project_compare. - Kinetix Scholar & SEO Pro: Google Scholar (Highwire Press) citation tags, BibTeX and RIS export, on-demand DOI lookup (only on an editor’s click, never saved automatically), JSON-LD @graph with Open Graph and Twitter tags (skipped when Yoast SEO, Rank Math or All in One SEO is active).
- Kinetix Core: tracking-free “Share on X” and “Copy link” buttons after posts.
- Paid features boot only behind
kinetix_ip_enabled/kinetix_sp_enabled.
Changed
- The free theme no longer hides the system cursor; cursor, slider and marquee CSS and JS left the theme.
[2.0.0] - 2026-11-11
feat(cpt-vault): build Production Vault (single/archive-project) with Grid/List view switcher and Behance integration
Added
- Kinetix Core:
kinetix_projectandkinetix_researchpost types,kinetix_project_typeandkinetix_research_areataxonomies, REST-exposed sanitised meta (client, year, role, cover colours, external link, compare images; authors, journal, date, DOI, PDF, volume, issue, pages, preprint), classic meta boxes with a media picker, rewrite rules rebuilt on activation. - Production Vault: archive with project-type filter pills (real links) and a grid/list switcher that remembers the visitor’s choice; overlay, spotlight and scholar card components.
- Case study page: gradient or image cover, client / role / year row, external link labelled
“View on Behance” for behance.net, and the
kinetix_project_comparehook. - Research hub: paper cards and paper pages with authors, journal, DOI, PDF and abstract.
[1.8.0] - 2026-11-11
feat(customizer): add granular glassmorphism sliders, blur controls, button geometry, and dynamic CSS compiler
Added
- Kinetix Customizer panel: Header, Footer, Glass & surfaces, Buttons, Typography (6 pairings), Colours (6), Projects; every setting strictly sanitised with contract defaults.
- Custom controls: range slider with live value, visual radio (inline SVG thumbnails), iOS-style switch.
- Dynamic CSS compiler:
:rootvariables (hex + RGB triplets) and body classes, live preview via postMessage; the Tailwind palette (zinc / amber / cyan / white) follows the Customizer. kinetix-glass.css: glass on/off, blur, surface and border alpha, card hover (lift, neon rim, flat), button shapes and shimmer / glow animations, light scheme, reduced motion.- Google Fonts load per chosen pairing.
Fixed (review)
- An extreme blur value (
1e999) clamps to 40 instead of warning; values added through thekinetix_css_variablesfilter cannot inject/*,url(or quotes; light-scheme body text meets contrast.
[1.5.0] - 2026-11-11
feat(headers): implement 4 premade header variants, smart-hide scroll physics, and custom header builder
Added
- Five headers: Floating Glass Pill, Edge-to-Edge Frosted Bar, Split Islands, Magazine Double-Deck and the Custom Header Builder (brand, nav, status, search, social, theme switch, CTA in any order).
- Scroll modes: smart-hide, sticky and static (
data-scrollon the navbar). - Shared full-screen mobile drawer, accessible search dialog and a light/dark switch that persists.
- Three footers: status capsule, minimal and five-column magazine; widget areas
footer-2andfooter-3; actionskinetix_before_headerandkinetix_after_footer.
Changed
- Copyright fallback reads ”© YEAR Site name.”; crowded menus wrap; long titles truncate on phones.
- Minimum PHP is 8.1 (Istiak’s call); smoke tests run on PHP 8.5, the version Playground really runs. Correction to 1.3.0: its “PHP 8.0” smoke runs were PHP 8.5, and the run covered 22 requests and 15 seeded posts.
Verified
- 244 header × scroll × footer renders with zero PHP warnings (builder run); lint clean.
[1.3.0] - 2026-11-11
feat(core): build complete WordPress template hierarchy and defensive PHP bootstrapper
Added
- Templates:
header.php,footer.php,index.php(blog index),front-page.php(static page full width, or the blog index),single.php,page.php,archive.php,search.php,404.php,comments.php,sidebar.php,searchform.phpandpage-templates/template-canvas.php. - Template parts:
site-brand,content/card,content/none,content/posts-index. inc/template-tags.php(icons, reading time, intros, category pills, pagination) andinc/template-functions.php(widget areas, menu link classes, page-list menu fallback, excerpts, archive titles, comment markup).inc/core/class-kinetix-enqueue.php: fonts, compiled Tailwind, tokens, design CSS and only the scripts each view needs; file-time cache busting whenSCRIPT_DEBUGis on.inc/core/class-kinetix-plugin-notice.php: one dismissible notice recommending the free Kinetix Core plugin (activate link when installed). Replaces bundling the TGM Plugin Activation library; WordPress.org allows recommending only plugins it hosts, and never automatic installs.- Tailwind CSS 3.4.19 compiled locally (
kinetix-theme/tailwind.config.js,assets/src/kinetix.csstoassets/css/kinetix-tailwind.css); no CDN. - Inline SVG icons from lucide-static 1.62.0 (
inc/icons.php, generated byscripts/build-icons.mjs); no icon script at runtime. assets/js/kinetix-reading-progress.js(single posts only).package.jsonwith pinned build tools;npm run build.- Smoke test: seeded content (14 posts, sticky, password-protected, threaded comments, rich content, footer menu, author bio), a theme-only mode with a static front page and posts page, 23 URLs including wp-admin screens, a port-in-use check and a readiness wait.
Changed
- Category filter on the blog is now real category links instead of a client-side filter;
assets/js/kinetix-blog.jsremoved. - The theme is mounted as
wp-content/themes/kinetixin tests: the folder name must match thekinetixtext domain on WordPress.org. - Characters lost in the static pages (
?in place of·,©and×) are correct in the templates. The static pages onmainstill show?.
Not in this version
- Page templates for Sprints, About and Intake: delivered as starter-site layouts in v3.0.0.
- Share buttons and the intake form: plugin territory under WordPress.org rules, delivered in the companion plugins.
Verified
scripts/lint-php.sh: 26 PHP files clean.scripts/smoke-test.sh: PHP 8.0 and 8.5, with all plugins and with none: 23 URLs each, 0 PHP errors, emptydebug.log.
[1.1.0] - 2026-11-11
feat(monorepo): restructure repository into kinetix-theme and dependency-plugins architecture
Added
kinetix-theme/: WordPress theme root withstyle.css(theme header, GPL-2.0-or-later,:rootdesign tokens),functions.php(constants, theme supports,primaryandfootermenus, asset loading) and a self-containedindex.phpfallback template, so the theme activates cleanly.dependency-plugins/kinetix-core/,kinetix-interactions-pro/andkinetix-scholar-seo-pro/: one bootstrap file each with a valid plugin header, the ABSPATH guard, path and version constants and a singleton class (Kinetix_Core,Kinetix_Interactions_Pro,Kinetix_Scholar_SEO_Pro) that the theme can detect withclass_exists().scripts/lint-php.sh: runsphp -lon every PHP file and checks the ABSPATH guard on line 2.scripts/smoke-test.shandplayground/blueprint.json: boot WordPress 7.1.4 in WordPress Playground (no Docker) with the theme and all three plugins active andWP_DEBUGon, request front-end URLs and fail on any PHP warning, notice, deprecation or fatal error.
Changed
- Static site assets moved into the theme with history kept (
git mv):css/styles.csstokinetix-theme/assets/css/kinetix-base.css, andjs/*.jstokinetix-theme/assets/js/kinetix-*.js. - The ten static HTML pages moved to
design-reference/static-v1/as the visual source for the template conversion, with their asset paths pointed at the theme folder so they still render. The untouched static site stays onmainand tagv1.0.0. .gitignorenow also ignoresnode_modules/,vendor/,.cache/,.DS_Storeand*.zip.
Verified
scripts/lint-php.sh: 5 PHP files, no syntax errors, guard present.scripts/smoke-test.shon PHP 8.0 and PHP 8.5: 7 URLs, 0 PHP errors, emptydebug.log.
[1.0.0] - 2026-11-11
Static HTML portfolio (Tailwind via CDN, vanilla JavaScript), ten pages. Baseline before the
WordPress conversion. Kept on main and tag v1.0.0.