Changelog · current v3.5.0

What's new in Kinetix

All notable changes to the Kinetix theme and its companion plugins.

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 URI https://istiakahamed.com, Plugin URI and Author URI on all three plugins, Contributors: istiakahamedofficial in 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. Only api.openalex.org over 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 the kinetix_sp_openalex_mailto / kinetix_sp_openalex_api_key filters 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.org and api.datacite.org join 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 the kinetix_core_store_leads filter 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 their unicode-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_url filter returns an http(s) address (empty by default, so no link today). New filter kinetix_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-glow is 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.css loads 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.txt for the theme and all three plugins; theme screenshot.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 on main and tag v1.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 in scripts/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_options only).
  • Hot-swappable logo: drop custom-logo.svg or .png into assets/images/; filters kinetix_admin_brand_name and kinetix_admin_brand_logo_url (used by white-label).
  • Theme readme.txt with 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-leak card hover choice), comparison slider and CSS marquee, moved out of the theme; shortcodes [kinetix_slider] and [kinetix_marquee]; raw-to-real slider on projects through kinetix_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_project and kinetix_research post types, kinetix_project_type and kinetix_research_area taxonomies, 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_compare hook.
  • 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: :root variables (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 the kinetix_css_variables filter 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-scroll on 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-2 and footer-3; actions kinetix_before_header and kinetix_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.php and page-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) and inc/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 when SCRIPT_DEBUG is 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.css to assets/css/kinetix-tailwind.css); no CDN.
  • Inline SVG icons from lucide-static 1.62.0 (inc/icons.php, generated by scripts/build-icons.mjs); no icon script at runtime.
  • assets/js/kinetix-reading-progress.js (single posts only).
  • package.json with 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.js removed.
  • The theme is mounted as wp-content/themes/kinetix in tests: the folder name must match the kinetix text domain on WordPress.org.
  • Characters lost in the static pages (? in place of ·, © and ×) are correct in the templates. The static pages on main still 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, empty debug.log.

[1.1.0] - 2026-11-11

feat(monorepo): restructure repository into kinetix-theme and dependency-plugins architecture

Added

  • kinetix-theme/: WordPress theme root with style.css (theme header, GPL-2.0-or-later, :root design tokens), functions.php (constants, theme supports, primary and footer menus, asset loading) and a self-contained index.php fallback template, so the theme activates cleanly.
  • dependency-plugins/kinetix-core/, kinetix-interactions-pro/ and kinetix-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 with class_exists().
  • scripts/lint-php.sh: runs php -l on every PHP file and checks the ABSPATH guard on line 2.
  • scripts/smoke-test.sh and playground/blueprint.json: boot WordPress 7.1.4 in WordPress Playground (no Docker) with the theme and all three plugins active and WP_DEBUG on, 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.css to kinetix-theme/assets/css/kinetix-base.css, and js/*.js to kinetix-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 on main and tag v1.0.0.
  • .gitignore now also ignores node_modules/, vendor/, .cache/, .DS_Store and *.zip.

Verified

  • scripts/lint-php.sh: 5 PHP files, no syntax errors, guard present.
  • scripts/smoke-test.sh on PHP 8.0 and PHP 8.5: 7 URLs, 0 PHP errors, empty debug.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.