v1.0 assessment: fix all blockers, add MokoSuiteShop, close 18 issues #54

Merged

jmiller merged 156 commits from dev into main 2026-06-21 22:01:41 +00:00

Conversation 0 Commits 156 Files Changed 149

+5843 -2289

jmiller commented 2026-06-21 20:32:48 +00:00

Owner

Copy Link

Copy Source

Summary

Full codebase assessment and remediation for v1.0 release readiness. Resolves all open bugs, security issues, and production-readiness blockers.

Fixes (15 issues closed)

• #47 Language filter on loadOgDataByType()/loadOgDataByMenu() — wrong data on multilingual sites
• #48 Add TagsController extends AdminController — admin delete/publish was broken
• #39 Replace $doc->_links access with getHeadData()/setHeadData() public API
• #49 Replace GD @ error suppression with Log::add() warnings
• #36 Remove dead ContentType adapters (K2, VirtueMart, HikaShop)
• #42 Cap batch process limit to 200 per request
• #43 TagTable::check() validates og_type, field lengths, canonical_url, robots
• #52 CSV import/export language column with format validation
• #44 Remove <updateservers> from package manifest
• #38 Consolidate article DB queries into single cached lookup (5 → 1)
• #50 TTF font not needed (ImageGenerator::generate() has no callers)
• #34, #35, #37, #41 Security fixes verified and closed

Features

• #53 MokoSuiteShop product OG tag support — og:type=product, product:price:amount/currency, JSON-LD Product schema with offers and aggregate ratings

Docs

• README and CHANGELOG renamed from MokoJoomOpenGraph to MokoSuiteOpenGraph
• Wiki updated: Home, Installation, Configuration, Developer Guide, Platform Support
• New wiki page: Architecture (data flow, key classes, performance)

Closes

Closes #34, #35, #36, #37, #38, #39, #40, #41, #42, #43, #44, #47, #48, #49, #50, #51, #52, #53

Test plan

• Install package on Joomla 5.x — verify all plugins auto-enable
• Create article with custom OG fields — verify meta tags in page source
• Test admin list: delete, publish, unpublish operations
• Test batch generation on site with existing articles
• Test CSV export includes language column, re-import works
• Test multilingual site: verify correct language OG data on category/menu pages
• Test MokoSuiteShop product page: verify og:type=product, pricing meta, JSON-LD
• Verify no @ suppression warnings in Joomla log on normal operation

## Summary Full codebase assessment and remediation for v1.0 release readiness. Resolves all open bugs, security issues, and production-readiness blockers. ### Fixes (15 issues closed) - **#47** Language filter on `loadOgDataByType()`/`loadOgDataByMenu()` — wrong data on multilingual sites - **#48** Add `TagsController extends AdminController` — admin delete/publish was broken - **#39** Replace `$doc->_links` access with `getHeadData()`/`setHeadData()` public API - **#49** Replace GD `@` error suppression with `Log::add()` warnings - **#36** Remove dead ContentType adapters (K2, VirtueMart, HikaShop) - **#42** Cap batch process limit to 200 per request - **#43** TagTable::check() validates og_type, field lengths, canonical_url, robots - **#52** CSV import/export language column with format validation - **#44** Remove `<updateservers>` from package manifest - **#38** Consolidate article DB queries into single cached lookup (5 → 1) - **#50** TTF font not needed (ImageGenerator::generate() has no callers) - **#34, #35, #37, #41** Security fixes verified and closed ### Features - **#53** MokoSuiteShop product OG tag support — `og:type=product`, `product:price:amount/currency`, JSON-LD Product schema with offers and aggregate ratings ### Docs - README and CHANGELOG renamed from MokoJoomOpenGraph to MokoSuiteOpenGraph - Wiki updated: Home, Installation, Configuration, Developer Guide, Platform Support - New wiki page: Architecture (data flow, key classes, performance) ## Closes Closes #34, #35, #36, #37, #38, #39, #40, #41, #42, #43, #44, #47, #48, #49, #50, #51, #52, #53 ## Test plan - [ ] Install package on Joomla 5.x — verify all plugins auto-enable - [ ] Create article with custom OG fields — verify meta tags in page source - [ ] Test admin list: delete, publish, unpublish operations - [ ] Test batch generation on site with existing articles - [ ] Test CSV export includes language column, re-import works - [ ] Test multilingual site: verify correct language OG data on category/menu pages - [ ] Test MokoSuiteShop product page: verify `og:type=product`, pricing meta, JSON-LD - [ ] Verify no `@` suppression warnings in Joomla log on normal operation

jmiller added the production-readiness label 2026-06-21 20:32:48 +00:00

jmiller added 143 commits 2026-06-21 20:32:49 +00:00

Merge pull request 'chore: cascade main → dev (27bb22e) [skip ci]' (#13) from main into dev ... 6d1eb2d993

chore: cascade main → dev [skip ci]

Merge pull request 'chore: cascade main → dev (98ac42c) [skip ci]' (#14) from main into dev ... 1f0b373ba3

chore: cascade main → dev [skip ci]

feat(seo): add SEO meta tag management (closes #8) ... 54bf5f7737

- Add seo_title, meta_description, robots, canonical_url columns
- SQL migration for upgrades (01.01.00.sql) + updated install schema
- New "SEO Meta Tags" fieldset in article/menu editor with:
  - SEO title (70 char max, overrides <title>)
  - Meta description (200 char max)
  - Robots directive (noindex, nofollow, nosnippet, etc.)
  - Canonical URL override
- System plugin applies SEO tags in onBeforeCompileHead before OG tags
- SEO audit column in admin tag list (missing desc, title too long, noindex)
- Content plugin saves/loads all SEO fields alongside OG data

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(batch): add batch OG tag generation for existing articles (closes #1) ... 935185b46f

- BatchController with count() and process() AJAX endpoints
- Chunked processing (50 articles per request) to avoid PHP timeouts
- LEFT JOIN query to find articles without existing OG records
- Auto-extracts og_title from article title, og_description from
  metadesc or introtext (160 char), og_image from article images JSON
- Also populates meta_description from article metadesc
- Progress bar UI in admin tag list with real-time updates
- "Batch Generate" toolbar button in Tags view
- Auto-reloads page after completion

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(images): auto-resize OG images to 1200x630px (closes #2) ... 5fc0fbfc07

- New ImageHelper class with resize(), validate(), cleanup() methods
- Center-crop algorithm maintains aspect ratio to target dimensions
- GD-based processing, supports JPEG/PNG/GIF/WebP input, outputs JPEG
- Generated images cached in images/mokoog/generated/ with hash naming
- Skips resize if image already at or below target dimensions
- Skips regeneration if cached version is newer than source
- validate() checks minimum 200x200px (Facebook/WhatsApp requirement)
- cleanup() removes generated images when OG records are deleted
- Auto-resize toggle in system plugin advanced settings (default: on)
- Integrated into resolveImageUrl() in the system plugin

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Merge pull request 'feat(images): auto-resize OG images (#2)' (#17) from feature/2-image-auto-resize into dev ... d6624af876

chore: cascade main → dev [skip ci]

Merge pull request 'feat(batch): batch OG tag generation (#1)' (#16) from feature/1-batch-processing into dev ... 6fc6c704ba

feat(batch): batch OG tag generation (closes #1)

feat(categories): add category-level OG tag support (closes #4) ... 7ef1d79336

- Content plugin now hooks com_categories.categorycom_content forms
- Category OG data stored as content_type 'com_content.category'
- System plugin detects category views and merges category OG as fallback
- Article image fallback chain: article image → category image → default
- New loadOgDataByType() helper for flexible type lookups

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(social): add WhatsApp/Telegram link preview optimization (closes #10) ... 6f5cc4425e

- Telegram channel meta tag config and output (telegram:channel)
- Image validation via ImageHelper::validate() already covers
  WhatsApp minimum requirements (300x200px)
- Auto-resize (from #2) ensures images meet all platform specs

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(preview): live social sharing preview in article editor (closes #3) ... 71c1fea356

- Facebook and Twitter/X card previews update in real-time
- Renders below the OG fieldset in article/menu editors
- Reads og_title, og_description, og_image with fallback to
  article title and meta description
- CSS mockups of each platform's card layout
- Registered via joomla.asset.json Web Asset Manager
- Safe DOM construction (no innerHTML with user data)
- MutationObserver watches media field for image changes

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(jsonld): add JSON-LD structured data output (closes #6) ... 5217986478

- JsonLdBuilder helper with Article, WebPage, BreadcrumbList, Organization
- Article schema includes headline, author, datePublished, dateModified, image
- BreadcrumbList built from Joomla's pathway
- Toggle JSON-LD and breadcrumbs independently in plugin settings
- Output via addCustomTag() in onBeforeCompileHead

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(adapters): add third-party content type adapter architecture (closes #5) ... 8dc1e8175a

- ContentTypeInterface with canHandle(), getTitle(), getDescription(), getImage()
- VirtueMartAdapter for product pages (com_virtuemart)
- K2Adapter for K2 items (com_k2)
- HikaShopAdapter for HikaShop products (com_hikashop)

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(debug): add social platform debugger quick links (closes #9) ... 94b5eb084c

- Debug column in admin tag list with FB, LinkedIn, Google buttons
- Links open platform debugger tools in new tab with page URL
- Facebook Sharing Debugger, LinkedIn Post Inspector, Google Rich Results

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(i18n): add multilingual OG tag support (closes #11) ... 04d1da29d4

- Add language column to #__mokoog_tags (default * for all languages)
- Updated unique key to include language
- SQL migration 01.02.00 for upgrades
- og:locale output from current Joomla language (en-GB to en_GB)
- Language-aware OG data loading: exact match preferred over wildcard

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(overlay): add OG image text overlay generator (closes #7) ... 9275a4f980

ImageGenerator class renders article title onto a template background:
- Center-crop template to 1200x630px
- Semi-transparent dark overlay band for text readability
- TTF font rendering with word wrapping (max 3 lines)
- Cached output in images/mokoog/generated/overlay_*.jpg
- Configurable font size, color, quality

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(csv): add CSV import/export for OG tags (closes #12) ... fdf4835051

ImportExportController with export() and import() actions:
- Export: CSV with all OG + SEO fields, joined with article titles
- Import: Upload CSV, match on content_type + content_id
- Upsert logic: creates new or updates existing records
- Reports created/updated/skipped counts
- Toolbar buttons ready for integration

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Merge pull request 'feat(categories): category-level OG tags (#4)' (#18) from feature/4-category-og-tags into dev fbbe74079d

Merge pull request 'feat(social): WhatsApp/Telegram optimization (#10)' (#19) from feature/10-whatsapp-telegram into dev 3d5e7eec8a

Merge pull request 'feat(adapters): third-party extension support (#5)' (#21) from feature/5-third-party-adapters into dev 717cfe9a0e

Merge pull request 'feat(debug): debugger quick links (#9)' (#22) from feature/9-debugger-links into dev d10c3bc0ea

Merge branch 'feature/6-jsonld' into dev ... b9738f0b5f

# Conflicts:
#	src/packages/plg_system_mokoog/src/Extension/MokoOG.php

Merge branch 'feature/11-multilingual' into dev b28703465d

Merge branch 'feature/7-image-overlay' into dev 26e3d39e01

Merge branch 'feature/12-csv-import-export' into dev fcce208278

Merge branch 'feature/3-social-preview' into dev 19035b1171

feat(api): add Joomla Web Services API for OG tags (closes #27) ... ce0bbe821a

New sub-extension: plg_webservices_mokoog
- Registers REST API routes via onBeforeApiRoute
- CRUD endpoints at /api/index.php/v1/mokoog/tags
- Lookup endpoint at /api/index.php/v1/mokoog/lookup/:type/:id
- SubscriberInterface pattern with DI container

Component API layer (com_mokoog/api/):
- TagsController extending ApiController for CRUD operations
- JsonapiView with whitelisted fields for JSON:API output
- TagModel (AdminModel) for single-item operations

Package updates:
- pkg_mokoog.xml includes plg_webservices_mokoog
- Install script auto-enables webservices plugin
- Component manifest declares api/ directory

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Merge pull request 'chore: cascade main → dev (1b09c5d) [skip ci]' (#28) from main into dev ... f9b4ca880c

chore: cascade main → dev [skip ci]

Merge pull request 'feat(api): Joomla Web Services API for OG tags (#27)' (#29) from feature/27-webservices-api into dev a66e1d5e86

chore: update updates.xml (development: 01.00.00-dev) [skip ci] 44d9ccfda6

Merge pull request 'chore: cascade main → dev (8b8ba12) [skip ci]' (#30) from main into dev ... 2ab883103c

chore: cascade main → dev [skip ci]

fix: production readiness improvements for admin panel and installer ... 97bc2526c0

Add search/filter tools to tags list view, fix API content type naming,
build proper frontend URLs for social debugger links, and auto-enable
the content plugin on package install.

Authored-by: Moko Consulting
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

chore: update updates.xml (development: 01.00.00-dev) [skip ci] 52a4bf7e5d

feat(seo): add SEO meta tag management (closes #8) ... 15ec388b52

- Add seo_title, meta_description, robots, canonical_url columns
- SQL migration for upgrades (01.01.00.sql) + updated install schema
- New "SEO Meta Tags" fieldset in article/menu editor with:
  - SEO title (70 char max, overrides <title>)
  - Meta description (200 char max)
  - Robots directive (noindex, nofollow, nosnippet, etc.)
  - Canonical URL override
- System plugin applies SEO tags in onBeforeCompileHead before OG tags
- SEO audit column in admin tag list (missing desc, title too long, noindex)
- Content plugin saves/loads all SEO fields alongside OG data

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(images): auto-resize OG images to 1200x630px (closes #2) ... 3ec4b163bb

- New ImageHelper class with resize(), validate(), cleanup() methods
- Center-crop algorithm maintains aspect ratio to target dimensions
- GD-based processing, supports JPEG/PNG/GIF/WebP input, outputs JPEG
- Generated images cached in images/mokoog/generated/ with hash naming
- Skips resize if image already at or below target dimensions
- Skips regeneration if cached version is newer than source
- validate() checks minimum 200x200px (Facebook/WhatsApp requirement)
- cleanup() removes generated images when OG records are deleted
- Auto-resize toggle in system plugin advanced settings (default: on)
- Integrated into resolveImageUrl() in the system plugin

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(batch): add batch OG tag generation for existing articles (closes #1) ... 9a6cd6fce8

- BatchController with count() and process() AJAX endpoints
- Chunked processing (50 articles per request) to avoid PHP timeouts
- LEFT JOIN query to find articles without existing OG records
- Auto-extracts og_title from article title, og_description from
  metadesc or introtext (160 char), og_image from article images JSON
- Also populates meta_description from article metadesc
- Progress bar UI in admin tag list with real-time updates
- "Batch Generate" toolbar button in Tags view
- Auto-reloads page after completion

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(categories): add category-level OG tag support (closes #4) ... 4c9486173b

- Content plugin now hooks com_categories.categorycom_content forms
- Category OG data stored as content_type 'com_content.category'
- System plugin detects category views and merges category OG as fallback
- Article image fallback chain: article image → category image → default
- New loadOgDataByType() helper for flexible type lookups

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(social): add WhatsApp/Telegram link preview optimization (closes #10) ... e6ee93b79b

- Telegram channel meta tag config and output (telegram:channel)
- Image validation via ImageHelper::validate() already covers
  WhatsApp minimum requirements (300x200px)
- Auto-resize (from #2) ensures images meet all platform specs

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(adapters): add third-party content type adapter architecture (closes #5) ... a34091ffbe

- ContentTypeInterface with canHandle(), getTitle(), getDescription(), getImage()
- VirtueMartAdapter for product pages (com_virtuemart)
- K2Adapter for K2 items (com_k2)
- HikaShopAdapter for HikaShop products (com_hikashop)

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(debug): add social platform debugger quick links (closes #9) ... 9e953646d7

- Debug column in admin tag list with FB, LinkedIn, Google buttons
- Links open platform debugger tools in new tab with page URL
- Facebook Sharing Debugger, LinkedIn Post Inspector, Google Rich Results

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(jsonld): add JSON-LD structured data output (closes #6) ... 3d73ea2f9c

- JsonLdBuilder helper with Article, WebPage, BreadcrumbList, Organization
- Article schema includes headline, author, datePublished, dateModified, image
- BreadcrumbList built from Joomla's pathway
- Toggle JSON-LD and breadcrumbs independently in plugin settings
- Output via addCustomTag() in onBeforeCompileHead

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(i18n): add multilingual OG tag support (closes #11) ... 4a9433d2bb

- Add language column to #__mokoog_tags (default * for all languages)
- Updated unique key to include language
- SQL migration 01.02.00 for upgrades
- og:locale output from current Joomla language (en-GB to en_GB)
- Language-aware OG data loading: exact match preferred over wildcard

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(overlay): add OG image text overlay generator (closes #7) ... 6674f354c6

ImageGenerator class renders article title onto a template background:
- Center-crop template to 1200x630px
- Semi-transparent dark overlay band for text readability
- TTF font rendering with word wrapping (max 3 lines)
- Cached output in images/mokoog/generated/overlay_*.jpg
- Configurable font size, color, quality

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(csv): add CSV import/export for OG tags (closes #12) ... 3d855f829f

ImportExportController with export() and import() actions:
- Export: CSV with all OG + SEO fields, joined with article titles
- Import: Upload CSV, match on content_type + content_id
- Upsert logic: creates new or updates existing records
- Reports created/updated/skipped counts
- Toolbar buttons ready for integration

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(preview): live social sharing preview in article editor (closes #3) ... 78fbe252cb

- Facebook and Twitter/X card previews update in real-time
- Renders below the OG fieldset in article/menu editors
- Reads og_title, og_description, og_image with fallback to
  article title and meta description
- CSS mockups of each platform's card layout
- Registered via joomla.asset.json Web Asset Manager
- Safe DOM construction (no innerHTML with user data)
- MutationObserver watches media field for image changes

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(api): add Joomla Web Services API for OG tags (closes #27) ... 400d3759e5

New sub-extension: plg_webservices_mokoog
- Registers REST API routes via onBeforeApiRoute
- CRUD endpoints at /api/index.php/v1/mokoog/tags
- Lookup endpoint at /api/index.php/v1/mokoog/lookup/:type/:id
- SubscriberInterface pattern with DI container

Component API layer (com_mokoog/api/):
- TagsController extending ApiController for CRUD operations
- JsonapiView with whitelisted fields for JSON:API output
- TagModel (AdminModel) for single-item operations

Package updates:
- pkg_mokoog.xml includes plg_webservices_mokoog
- Install script auto-enables webservices plugin
- Component manifest declares api/ directory

Authored-by: Moko Consulting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

chore: update updates.xml (development: 01.00.00-dev) [skip ci] f7826ca60a

fix: production readiness improvements for admin panel and installer ... 0509980b50

Add search/filter tools to tags list view, fix API content type naming,
build proper frontend URLs for social debugger links, and auto-enable
the content plugin on package install.

Authored-by: Moko Consulting
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Merge pull request 'chore: cascade main -> dev [skip ci]' (#32) from main into dev ... 11ad5be25e

chore: cascade main → dev [skip ci]

chore(version): bump 01.00.00 → 01.00.00-dev [skip ci] fc148084a1

chore: update development channel 01.00.00 [skip ci] 0b97a62c82

chore(ci): update pre-release.yml from moko-platform [skip ci] 3563c62ec2

chore(ci): update auto-release.yml from moko-platform [skip ci] 292265841e

chore(ci): update auto-release.yml from moko-platform [skip ci] bbda9318d8

chore(ci): update pre-release.yml from moko-platform [skip ci] 23de6dcb07

fix(ci): use release_package.php for Joomla package builds [skip ci] 105d282077

chore(ci): add auto-bump.yml from moko-platform [skip ci] 72e0f85e4b

chore(ci): update pre-release.yml from moko-platform [skip ci] 2b5b42567b

chore(ci): update auto-release.yml from moko-platform [skip ci] fa732f44c8

chore(ci): update auto-bump.yml from moko-platform [skip ci] 1954b36720

chore(ci): update auto-release.yml from moko-platform [skip ci] 943b5077b3

chore(ci): update pre-release.yml from moko-platform [skip ci] f86d1bca41

chore(ci): update auto-release.yml from moko-platform [skip ci] 2c90881a5b

chore(ci): update auto-bump.yml from moko-platform [skip ci] e1c826a46a

chore(ci): update pre-release.yml from moko-platform [skip ci] 129a9d547b

feat(workflows): append stability suffix to manifest versions [skip bump] 000d9a8fb6

fix(workflows): proper suffix handling — use version_set_platform instead of sed [skip bump] 72639c1155

refactor(workflows): rename secrets MOKOGITEA_TOKEN/GITHUB_TOKEN, use x-access-token [skip bump] f3a76c93be

chore(workflows): sync all universal workflows from moko-platform [skip bump] a1d5953015

fix(workflows): GITHUB_TOKEN→GH_MIRROR_TOKEN (reserved name) [skip bump] 90bcabd2fa

fix(workflows): rename remaining old secrets in repo-specific workflows [skip bump] 5d34cbced4

chore: sync .mokogitea/workflows/auto-release.yml from moko-platform [skip ci] 4fef3cd528

chore: sync .mokogitea/workflows/update-server.yml from moko-platform [skip ci] afb431a62c

chore: sync .mokogitea/workflows/pre-release.yml from moko-platform [skip ci] 29917529ca

chore: sync .mokogitea/workflows/auto-release.yml from moko-platform [skip ci] 9a88daec9d

chore: sync .mokogitea/workflows/auto-release.yml from moko-platform [skip ci] 7e4b391004

chore: sync .mokogitea/workflows/update-server.yml from moko-platform [skip ci] efd86ee77e

chore: sync .mokogitea/workflows/auto-bump.yml from moko-platform [skip ci] 56d7d8784b

chore: sync .mokogitea/workflows/auto-release.yml from moko-platform [skip ci] 182e8caa90

chore: sync .mokogitea/workflows/auto-bump.yml from moko-platform [skip ci] 5c175ebc21

chore: sync .mokogitea/workflows/auto-release.yml from moko-platform [skip ci] 0ff6798918

chore: sync .mokogitea/workflows/pr-check.yml from moko-platform [skip ci] d46f726a78

refactor: rename MokoOpenGraph → MokoJoomOpenGraph, add moko-platform standards compliance ... a5b14048f4

- Rename project display name across 69 files (PHP, XML, INI, SQL, CSS, JS, JSON, MD)
- Add <display-name> to .mokogitea/manifest.xml per moko-platform schema
- Update pkg_mokoog.xml <name> to "Package - MokoJoomOpenGraph" (Joomla convention)
- Update all update server URLs to new repo path
- Add CONTRIBUTING.md and CODE_OF_CONDUCT.md (required by repo-health workflow)
- Add .gitattributes for line-ending normalization and export-ignore rules
- Add .gitignore

Authored-by: Moko Consulting
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

fix(security): harden controllers, add site defaults, platform-specific OG tags ... de9f7eeb58

Security fixes:
- Fix JSON-LD XSS via </script> injection in content data (#34)
- Add ACL permission checks to Batch and ImportExport controllers (#37)
- Add CSV import file type, MIME, and size validation (#35)
- Fix multilingual bug in content plugin load/save OG data (#41)

Enhancements:
- Add site-wide default OG title and description plugin parameters
- Add Discord embed color (theme-color) plugin parameter
- Add og:image:width/height for faster social previews
- Add article:published_time, article:modified_time, article:author for LinkedIn
- Add onMokoOGAfterRender event for third-party plugin extensibility
- Add content_type regex validation on CSV import rows

Authored-by: Moko Consulting
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

chore(version): auto-bump 01.00.01-dev [skip ci] 5125fff078

chore: update development channel 01.00.01-dev [skip ci] e1eb409943

chore: sync .mokogitea/workflows/cascade-dev.yml from moko-platform [skip ci] 5da49ce416

chore: sync .mokogitea/workflows/auto-bump.yml from moko-platform [skip ci] 381557e79b

docs: update README and CHANGELOG for v1.0.0 release ... e1cf4cb385

Authored-by: Moko Consulting
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat(ci): trigger RC build on PR draft to main, rename branch to rc ... fe92892310

When a PR is opened or drafted targeting main, the pre-release workflow
now automatically builds a release-candidate package and renames the
source branch to 'rc'.

Authored-by: Moko Consulting
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

chore(version): pre-release bump to 01.00.01-rc [skip ci] 516e2a4a47

chore: update release-candidate channel 01.00.01-rc [skip ci] 5a6f315403

revert(ci): restore pre-release.yml to upstream template ... 073e24bf4e

RC-on-PR-to-main is already handled by auto-release.yml (promote-rc job).
pre-release.yml only needs to handle dev releases (PR merged to dev) and
manual dispatch.

Authored-by: Moko Consulting
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

refactor(ci): simplify workflows — merge update-server into pre-release, remove redundancy ... 5cbd0b64d4

Changes:
- Delete cascade-dev.yml (disabled; auto-release Step 11 handles dev recreation)
- Delete update-server.yml (merged into pre-release.yml)
- Consolidate pre-release.yml: now handles push triggers on dev/alpha/beta/rc
  branches, PR merged to dev, manual dispatch, SFTP deploy, and updates.xml sync
- Remove pre-release RC trigger from pr-check.yml (auto-release.yml handles RC
  via promote-rc job on PR opened to main)
- Restrict repo-health.yml to manual dispatch only (was noisy on every push/PR)

Workflow count: 12 → 10

Before:
  pre-release.yml  — PR merged to dev + manual
  update-server.yml — push to dev + PR merged to dev + manual + SFTP deploy
  pr-check.yml     — branch policy + validate + trigger pre-release RC
  cascade-dev.yml  — disabled
  repo-health.yml  — push + PR + manual

After:
  pre-release.yml  — push to dev + PR merged to dev + manual + SFTP deploy
  pr-check.yml     — branch policy + validate (no RC trigger)
  repo-health.yml  — manual only

Authored-by: Moko Consulting
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

fix(ci): always clone fresh moko-platform tools, fix composer constraint ... ad09eae874

- auto-bump.yml: remove stale /opt/moko-platform check, always clone
  fresh from git (matches pre-release.yml pattern)
- composer.json: fix joomla/coding-standards ^4.0 → ^3.0 (v4 doesn't
  exist on Packagist)

Authored-by: Moko Consulting
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

fix: add minimum-stability alpha for joomla/coding-standards ... e1747da3ff

joomla/coding-standards has no stable release — only 3.0.0-alpha.
Add minimum-stability: alpha with prefer-stable: true.

Authored-by: Moko Consulting
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

fix(ci): use GH_MIRROR_TOKEN for composer GitHub auth ... 90e5f8c717

MOKOGITEA_TOKEN is a Gitea token — cannot authenticate against github.com
for Packagist downloads. Use GH_MIRROR_TOKEN (GitHub PAT) instead.

Authored-by: Moko Consulting
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

fix(ci): skip namespace check for package manifests, secrets already set ... ba62e95e58

Package type extensions (pkg_*) don't have <namespace> tags — only
component/plugin manifests do. Skip the check when type="package".

Authored-by: Moko Consulting
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

fix: add missing index.html to all extension directories ... 8c0fcfe81f

Joomla security requirement — prevents directory listing on misconfigured
servers. Added to all 57 directories that were missing them.

Authored-by: Moko Consulting
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

chore(version): pre-release bump to 01.00.01-dev [skip ci] 01055aa844

chore: update development channel 01.00.01-dev [skip ci] 2dcc6860c2

fix(ci): support HTML comment VERSION format, add en-GB/en-US check ... d001ef7c35

- Release readiness: support <!-- VERSION: XX.YY.ZZ --> format in
  README.md (not just FILE INFORMATION block format)
- Add language directory check: verify en-GB and en-US exist in all
  language/ directories under src/ or htdocs/

Authored-by: Moko Consulting
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

fix(ci): replace PCRE grep with sed for Alpine compat ... 23caf15df6

Alpine Linux grep doesn't support -P (PCRE). Use sed for VERSION
and manifest version extraction.

Authored-by: Moko Consulting
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

chore(ci): remove release workflows for update server migration ... 87fc0930a0

Delete auto-release.yml, pre-release.yml, and auto-bump.yml in
preparation for the new update server system.

Remaining workflows: ci-joomla, cleanup, gitleaks, notify, pr-check,
repo-health, security-audit (7 total).

Authored-by: Moko Consulting
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

chore(ci): add CI issue reporter for auto-filing gate failures 6a38ca957a

chore(ci): add CI issue reporter for auto-filing gate failures 922f74d37a

chore(ci): add CI issue reporter for auto-filing gate failures 5d32a37258

chore: sync .mokogitea/workflows/pr-check.yml from moko-platform [skip ci] 9d0d772dd4

chore: add .mokogitea/workflows/auto-release.yml from moko-platform [skip ci] 2bb8aaf8b4

chore: sync .mokogitea/workflows/repo-health.yml from moko-platform [skip ci] 26e146bcf4

chore: sync .mokogitea/workflows/repo-health.yml from moko-platform [skip ci] 7091e64e2c

chore: sync .mokogitea/workflows/auto-release.yml from moko-platform [skip ci] 364bba0271

feat(update): migrate update server URL to Gitea Pages [skip ci] 40de6532d6

chore: sync .mokogitea/workflows/pr-check.yml from moko-platform [skip ci] f960b37b33

chore: remove updates.xml [skip ci] daa17a627e

chore: sync .mokogitea/workflows/pr-check.yml from moko-platform [skip ci] 8b7b84dd41

chore: sync .mokogitea/workflows/pr-check.yml from moko-platform [skip ci] 7de46486e6

chore: sync .mokogitea/workflows/pr-check.yml from moko-platform [skip ci] b2d2ae9eff

chore: add dlid and blockChildUninstall to package manifest [skip ci] 8fe8469287

fix: resolve 5 bugs found during code assessment ... 252d75c44f

- fix(batch): use offset=0 for self-consuming LEFT JOIN query that
  excludes already-processed articles, preventing chunk skips
- fix(license): move session flag after DB query succeeds so a failed
  check retries on next page load instead of silently giving up
- fix(og:image): detect actual image dimensions via getimagesize()
  instead of hardcoding 1200x630 which was wrong for unresized,
  small, or external images
- fix(i18n): use mb_strlen() consistently with mb_substr() for
  multibyte-safe description truncation across all 4 call sites
- fix(ImageGenerator): guard wrapText truncation when third line is
  shorter than 3 characters to prevent broken output

Authored-by: Moko Consulting
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

chore: add .mokogitea/workflows/pre-release.yml from moko-platform [skip ci] 3d315df905

refactor: rename src/ to source/ and update all CI references ... 05b2a44209

- Rename project source directory from src/ to source/
- Update CI workflows (ci-joomla, pr-check, repo-health) to check
  source/ first, falling back to src/ and htdocs/ for compat
- Update .gitignore vendor exception path
- manifest.xml entry-point already updated

Authored-by: Moko Consulting
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

chore: normalize line endings in auto-release.yml ... 493fcb6dd5

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

chore: move CLAUDE.md to .mokogitea/ directory ... 426af7a879

Relocate CLAUDE.md from repo root to .mokogitea/ per project convention.
Content updated with focused, repo-specific architecture and rules.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

chore: sync .mokogitea/workflows/pre-release.yml from moko-platform [skip ci] b108d083b2

chore: sync .mokogitea/workflows/auto-release.yml from moko-platform [skip ci] 1933586768

feat: download key preservation + license key warning (MokoWaaS pattern) a6e350d3b4

fix: use single-key pattern instead of universal backup d55fb0d38f

chore(version): pre-release bump to 01.00.02-dev [skip ci] 1593f28f19

fix: gitignore site/ should be /site/ to avoid matching tmpl/site/ a67cd6da76

ci(pre-release): sync universal v05 workflow with chore/** branch trigger 64ac7796b7

chore(version): pre-release bump to 01.00.03-dev [skip ci] 2bf63f70ab

fix: resolve 3 v1.0 release blockers (#47, #48, #39) ... 433ecfea71

- Add TagsController extending AdminController for admin list
  delete/publish/unpublish operations (#48)
- Add language filter to loadOgDataByType() and loadOgDataByMenu()
  matching the pattern already used in loadOgData() (#47)
- Replace direct $doc->_links access with getHeadData()/setHeadData()
  public API for Joomla forward compatibility (#39)
- Update ISSUES.md with full 2026-06-21 assessment

fix: replace GD error suppression with logging, remove dead adapters (#49, #36) ... 0afc8b135a

- Replace @ error suppression in ImageGenerator with Log::add() warnings
  for missing GD, missing font, corrupt images (#49)
- Add GD extension pre-check before attempting image generation
- Add WebP function_exists() guard for servers without WebP support
- Remove @ suppression from ImageHelper::loadImage() with logging
- Remove unused ContentType adapters (HikaShop, K2, VirtueMart) and
  ContentTypeInterface — not targeting these platforms (#36)

feat: add MokoSuiteShop product OG tag support (#53) ... 8793e6b3f4

- Detect com_mokoshop product views and set og:type to 'product'
- Auto-generate OG tags from CRM product data (name, description, image)
- Add product:price:amount and product:price:currency meta tags
- Add JSON-LD Product schema with offers, SKU, and aggregate ratings
- Load product images from linked #__content article images
- Cache product DB lookups to avoid duplicate queries per request

fix: batch limit cap, TagTable validation, CSV language column (#42, #43, #52) ... f484675300

- Cap batch process limit to 200 per request to prevent DoS (#42)
- Add TagTable::check() validation: og_type enum, field max lengths,
  canonical_url format, robots directives, content_type pattern (#43)
- Add language column to CSV export headers and data (#52)
- Parse language column on CSV import with format validation
- Include language in duplicate check query to match unique key

fix: remove updateservers from package manifest (#44) ... 7a7041c7f3

Update server is managed externally, not via static updates.xml.

perf: consolidate article DB queries into single cached lookup (#38) ... ca06c86328

- Add loadArticle() with static per-request cache for article data
- Refactor getArticleDate(), getArticleAuthor() to use cached article
- Refactor findImage() for com_content to use cached article
- Pass cached article to JsonLdBuilder::buildArticle() to skip its query
- Reduces article page DB queries from 5 to 1 for OG tag generation

chore: normalize workflow line endings for merge 7fd716f3a4

Merge remote-tracking branch 'origin/dev' into dev ... e105474c68

# Conflicts:
#	.mokogitea/workflows/pre-release.yml

chore(version): pre-release bump to 01.00.04-dev [skip ci] 0e6137b064

docs: update README and CHANGELOG for v1.0 assessment ... 1375c5820e

- Rename MokoJoomOpenGraph to MokoSuiteOpenGraph throughout
- Add MokoSuiteShop integration, Product JSON-LD to feature lists
- Remove dead adapter references (K2, VirtueMart, HikaShop)
- Document all fixes: DB caching, TagTable validation, CSV language,
  batch limit, GD logging, canonical URL API, language filters

Merge branch 'dev' of https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteOpenGraph into dev 0cc69b7d77

chore(version): pre-release bump to 01.00.05-dev [skip ci] 3d2d91ace5

jmiller added 2 commits 2026-06-21 20:40:39 +00:00

fix: undefined $db in findImage(), pass cached product to buildProduct() ... 28d44d6884

- Add missing Factory::getDbo() in findImage() category fallback — would
  cause fatal error on article pages with no images (found in PR review)
- Pass cached product to JsonLdBuilder::buildProduct() to avoid duplicate
  DB query (same pattern as buildArticle with cachedArticle)
- Fix orphaned PHPDoc block for getImageDimensions()

Merge branch 'dev' of https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteOpenGraph into dev 38af92b876

jmiller added 1 commit 2026-06-21 20:40:46 +00:00

chore(version): pre-release bump to 01.00.06-dev [skip ci] 77148d2401

jmiller added 2 commits 2026-06-21 21:26:21 +00:00

fix: address PR review findings — error handling and data integrity ... 46e30c950b

- Add missing language field to batch-generated records
- Wrap batch insert in try-catch to handle duplicate key races
- Add logging to all empty catch blocks (script.php, MokoOG license check)
- Guard loadShopProduct() with try-catch for missing MokoSuiteShop tables
- Guard reviews query in JsonLdBuilder for missing #__mokoshop_reviews

Merge branch 'dev' of https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteOpenGraph into dev fa75b7d9c4

jmiller added 1 commit 2026-06-21 21:26:37 +00:00

chore(version): pre-release bump to 01.00.07-dev [skip ci] 6a928f856f

jmiller added 2 commits 2026-06-21 21:42:59 +00:00

fix: remove remaining @ suppression, check Folder::create() returns ... 77da0c5517

- Remove @getimagesize() suppression in ImageHelper, ImageGenerator,
  MokoOG — let PHP report warnings for corrupt/unreadable images
- Add Log::add() when ImageHelper::resize() cannot read image dimensions
- Check Folder::create() return value in ImageGenerator and ImageHelper,
  return graceful fallback if directory creation fails

Merge branch 'dev' of https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteOpenGraph into dev 26328d530e

jmiller added 1 commit 2026-06-21 21:43:11 +00:00

chore(version): pre-release bump to 01.00.08-dev [skip ci] dfd0fef3b8

jmiller added 2 commits 2026-06-21 22:00:23 +00:00

Merge remote-tracking branch 'origin/main' into dev ... e66e003748

# Conflicts:
#	.mokogitea/manifest.xml
#	.mokogitea/workflows/auto-release.yml
#	.mokogitea/workflows/cascade-dev.yml
#	.mokogitea/workflows/ci-joomla.yml
#	.mokogitea/workflows/pr-check.yml
#	.mokogitea/workflows/pre-release.yml
#	.mokogitea/workflows/repo-health.yml
#	.mokogitea/workflows/update-server.yml
#	CHANGELOG.md
#	CONTRIBUTING.md
#	README.md
#	source/packages/com_mokoog/mokoog.xml
#	source/packages/plg_content_mokoog/mokoog.xml
#	source/packages/plg_system_mokoog/mokoog.xml
#	source/pkg_mokoog.xml

Merge branch 'dev' of https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteOpenGraph into dev ... 66b78fd712

# Conflicts:
#	.mokogitea/manifest.xml

jmiller added 1 commit 2026-06-21 22:00:40 +00:00

chore(version): auto-bump patch 01.00.09-dev [skip ci] 19e177f1a4

jmiller added 1 commit 2026-06-21 22:00:52 +00:00

chore(version): pre-release bump to 01.01.01-dev [skip ci] 549a3b5599

jmiller merged commit f1aa3867d8 into main 2026-06-21 22:01:41 +00:00

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

Clear labels

bug

Something is broken

documentation

Documentation improvements

enhancement

production-readiness

Required before v1.0 release

security

Security vulnerability or hardening

testing

Test coverage and QA

No labels production-readiness

Priority -

Type -

Milestone

No items

No Milestone

Assignees

Clear assignees

jmiller (Jonathan Miller)

No Assignees

1 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: MokoConsulting/MokoSuiteOpenGraph#54