Robot
bb9b155f00
Add a dedicated Extrusion view for importing existing Joomla components and PHP libraries into JCB. Unify component-folder and SQL-dump extrusion through a single engine. Add PHP class harvesting into JCB Powers, including automatic class matching and dependency linking. Add import pairing with Create, Update, and Skip controls, dry runs, and per-record change previews. Improve SQL schema reconstruction to preserve column types, defaults, keys, indexes, and table configuration. Improve field imports to preserve XML settings, options, GUID relationships, and storage formats without double-encoding subform data. Reuse shared field definitions across views and preserve existing customizations during repeated imports. Detect unchanged records and avoid unnecessary writes during repeated Extrusion runs. Restore language strings and compiler placeholders in imported code, field XML, view markup, and SQL. Improve Site View and Custom Admin View discovery, template recovery, and Dynamic Get relationships. Fix Power namespace reconstruction to correctly preserve custom aliases and apply NamespacePrefix and ComponentNamespace placeholders. Fix duplicate Compile button submissions that could start concurrent builds and cause intermittent folder creation or deletion errors. #1318. Add Repair Existing Power Namespaces with automatic matching and namespace-only updates that preserve class code, GUIDs, and settings. Improve Power discovery performance with component-scoped matching, dependency indexes, and reusable parsing. Protect Extrusion imports against ambiguous matches, conflicting compiler paths, and stale change previews. Improve Extrusion error reporting and recovery after interrupted import requests. Improve the Extrusion interface with folder pickers, grouped filtering, bulk selection, responsive layouts, and a dedicated dashboard icon. Fix Extrusion self-compilation by preserving runtime marker literals and align import authorization with native view-access permissions. Replace execution of imported SQL with static parsing and validate source paths without executing imported PHP. Complete JSON:API generation for API-enabled Admin Views, including CRUD operations, relationships, filtering, pagination, and field-level permissions. Include generated API files in component manifests so they are installed with compiled components. Add API_ROUTES and API_ROUTES_METHOD placeholders for linked webservices plugins, supporting routes by record ID, GUID, and unique fields. Add read-only API resources for supported Site Views and Custom Admin Views using their existing Dynamic Gets. Fix API record creation when IDs and GUIDs are omitted, generate record keys on the server, and preserve existing GUIDs during updates. Fix API item and list model selection, including resource names with irregular plural forms. Fix API read permissions to support read-only users and return native JSON:API access-denied responses instead of administrator redirects. Fix cross-site scripting risks in generated views through corrected text sanitization, Joomla-native HTML escaping, and field escape settings. Fix edit-own permission bypasses by checking stored record ownership and applying field permissions to the record being saved. Strengthen file upload and deletion permissions with ownership and component permission checks. Fix subform updates that could overwrite or reassign records belonging to another parent. Block unsafe URL schemes in Markdown links and images. Use cryptographically secure randomness for generated passwords and upload names, and sanitize uploaded filenames. Fix generated IIS library access configuration and add missing index.html files to compiled folders. Complete extraction of generated-code logic from the legacy Fields, Interpretation, and Infusion helpers into dedicated compiler services. Consolidate shared compiler logic across Joomla versions while retaining version-specific generation where required. Refactor the Power parser to use PHP's native lexer for reliable handling of modern syntax, multiline declarations, and complex types. Fix JCB Search to prevent matching records from being skipped when processing successive batches. Fix compilation of database-aware Joomla 4 modules caused by a missing utility class import. Fix CLI repository resolution to report unresolved repository GUIDs without triggering a fatal error. Fix PHP warnings when the compiler's placeholder report contains no results. Fix toolbar generation when descriptions are missing or null. Preserve original source line endings when compiler processing leaves the content unchanged.
239 lines
15 KiB
Plaintext
239 lines
15 KiB
Plaintext
|
|
# Joomla Component Builder ([JCB](https://www.joomlacomponentbuilder.com))
|
|
|
|
|
|
|
|
This is a professional-grade [Joomla 6.x](https://extensions.joomla.org/extension/component-builder/) component, created with [Joomla Component Builder (JCB)](https://www.joomlacomponentbuilder.com)—a uniquely advanced development engine for building and maintaining complete Joomla extensions.
|
|
|
|
> 🎥 [Original... Quick Hello World Demo](https://www.youtube.com/watch?v=IQfsLYIeblk&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&index=45), yes JCB has been around for over a decade.
|
|
|
|
JCB generates native Joomla components, plugins, and modules for Joomla 3.x, 4.x, and 5.x - and is already prepared for Joomla 6. Every compiled project is tailored for the specific version without needing backward compatibility plugins. With integrated version-aware compiling, smart boilerplating, and Git-powered project syncing, JCB is much more than a code generator-it's a **full-stack development pipeline for Joomla extensions**.
|
|
|
|
You can install this component easily. The latest release (**6.2.0**) is available on [Releases](https://git.vdm.dev/joomla/pkg-component-builder/releases) and updated frequently with full source access.
|
|
|
|
Upgrades are seamless through Joomla's built-in extension update mechanism.
|
|
|
|
---
|
|
|
|
## 🚀 Core Capabilities at a Glance
|
|
|
|
Here are just some of the key powers JCB brings:
|
|
|
|
* 🔁 **Bi-Directional IDE Sync** - Fetch custom logic from compiled projects and reintegrate on rebuild.
|
|
* 🧱 **Build Joomla Components, Plugins, and Modules** - Fully native and independently compiled.
|
|
* 🧠 **Superpowers (PHP Class Builder)** - Create namespaced abstract, interface, and trait-based PHP classes visually.
|
|
* 🔌 **Joomla Powers** - Intelligent Joomla class referencing via dynamic placeholders (JPKs) that adapt to Joomla versions.
|
|
* 🗃️ **Smart Boilerplating** - Start fast with 6+ curated demo blueprints for instant use or customization.
|
|
* 🔂 **Round-Trip Development** - Add, update, and persist changes across compiled code using insert/replace tags.
|
|
* 🔐 **Field Types Engine** - Blueprint reusable Joomla-native fields with constraints, security, DB structure, and logic.
|
|
* 🧬 **Admin Views, Custom Admin Views & Site Views** - Fine-grained design for structured or dynamic backend/front-end UIs.
|
|
* 🧮 **Dynamic GET Builder** - Advanced visual query designer for cross-table, filter-rich, deeply joined SQL fetches.
|
|
* 💡 **Snippets, Layouts, Templates & Libraries** - Shareable GUI-linked modules for reusable HTML/CSS/JS integration.
|
|
* 🧰 **Custom Code System** - Write logic once and reuse anywhere; full support for HTML & PHP placeholders and tracking.
|
|
* 🛠️ **Multi-Version Compilation** - Compile version-specific code for J3, J4, J5 without compatibility bloat.
|
|
* 📦 **Package Management** - Export/import blueprints, version control builds, sync with Git, and distribute clean packages.
|
|
* 🖥️ **CLI Integration** - Build commands natively via terminal using Joomla's CLI runner.
|
|
* 🌐 **Update Server Support** - Integrate custom update mechanisms for extensions post-deployment.
|
|
|
|
<details>
|
|
<summary>📚 View 80+ Additional Advanced Features</summary>
|
|
### 🧩 Architecture & Core Logic
|
|
|
|
* 🧠 **Super Powers**: Namespaced PHP classes (interfaces, traits, abstracts, finals) managed from GUI
|
|
* 🔌 **Joomla Powers**: Dynamic Joomla class resolution via JPK placeholders per Joomla version
|
|
* 🧱 **Compile native Components, Plugins & Modules** in one unified workflow
|
|
* 🔀 **Multi-version support** (J3, J4, J5, J6-ready) with per-version compilation
|
|
* 🚦 **Conditional logic injection** in models, views, controllers
|
|
* 🧬 **Reusable Admin Views** across multiple components
|
|
* 🧠 **Dynamic GET Builder** for visual cross-table queries
|
|
* 🔄 **Round-trip code integration** with file-to-database inserts/replaces
|
|
* 🧬 **Custom Admin Views** with full MVC override power
|
|
* 🧩 **Site Views** supporting public display of data with custom logic
|
|
* 🔗 **Model linking between views** using subforms and dynamic selectors
|
|
* 🧩 **Shared field reuse across views** and components
|
|
* 🎯 **Dynamic Field Visibility** conditions via user permission structure
|
|
* 📦 **Independent packaging** of views and logic for reuse
|
|
|
|
### 📁 File & Code Management
|
|
|
|
* 🧾 **Insert/Replace tags** for persistent file overrides
|
|
* 🗃️ **PHP & HTML custom code injection** via placeholder system
|
|
* 🛠️ **Automatic file synchronization** on rebuild
|
|
* 🧮 **Reverse string parser** to restore lang strings back to natural text
|
|
* 📋 **Line tracking** to see where code was compiled from
|
|
* 💾 **Auto language string export** from templates & views
|
|
* 🧰 **Helper classes and static utilities** included by default
|
|
|
|
### 🧠 Code Reuse & Blueprints
|
|
|
|
* 🧱 **Demo component blueprints** for rapid prototyping
|
|
* 🔁 **Blueprint export/import** via JSON files and Git repos
|
|
* 📎 **Shared field types** serve as field templates
|
|
* 🎛️ **Custom scripting per field** on get/save
|
|
* 🔀 **Field view-type override (admin vs config)**
|
|
|
|
### 🌐 Joomla CMS Integration
|
|
|
|
* 🔐 **ACL per view, field, item**
|
|
* 🧾 **Field-based Joomla config generation**
|
|
* 📘 **Support for Joomla categories/tags/custom fields**
|
|
* ⚙️ **CLI-ready components** with native terminal support
|
|
* 🛰️ **Joomla Update Server integration**
|
|
* 🧪 **Version-aware language string compilation**
|
|
* 📤 **Remote publishing to custom repo update streams**
|
|
|
|
### 🧠 Visual GUI & UX
|
|
|
|
* 🎨 **Layout builder** with inline layout reusability
|
|
* 📁 **Template builder** with overrides
|
|
* 🧠 **Snippets GUI** for code blocks linked to layouts/templates
|
|
* 🧬 **Field injection points in layout/template snippets**
|
|
* 🔁 **Dynamic reload on selection change** via JavaScript binding
|
|
* 📄 **Inline help descriptions** from config
|
|
* 🖱️ **Custom admin menus** and dashboard menu builders
|
|
|
|
### 🌍 Internationalization
|
|
|
|
* 🌐 **Excel import/export for language strings**
|
|
* 📁 **Per-field language control**
|
|
* 🧾 **Language string auto-indexing**
|
|
* 🔁 **Reverse engineering of language constants**
|
|
* 🧠 **Per-Joomla-version lang key mapping**
|
|
* 🔧 **GUI to rewrite or update lang string context**
|
|
|
|
### 📦 Packaging & Distribution
|
|
|
|
* 📤 **Push component to Git repo**
|
|
* 🔄 **Auto-compile and auto-tag packages**
|
|
* 🎁 **Auto-generated changelog from commits**
|
|
* 📬 **Component update URLs via GUI settings**
|
|
* 🏷️ **Version-aware build ID assignment**
|
|
|
|
### ⚙️ Compiler Engine Features
|
|
|
|
* ⚡ **Under-30-second build time** on large components
|
|
* 📦 **Memory-optimized ZIP builder**
|
|
* 📃 **Build summary report** after compilation
|
|
|
|
### 🧱 Custom Code System (Powerful Dual Feature)
|
|
|
|
* 🔧 **Universal reusable code blocks** (inject anywhere by key)
|
|
* 🪄 **Update detection & visual diffing** on reused code
|
|
* 🧬 **Multi-context custom code binding**
|
|
* 📄 **Dynamic placeholder variable injection**
|
|
* 🔁 **Nested custom code support**
|
|
* 🔥 **Advanced compiler hooks per code block**
|
|
* 🧠 **Round-trip tag tracking in PHP/HTML**
|
|
|
|
### 🛠 Field Type System
|
|
|
|
* 💡 **GUI-defined rules (required, unique, nullable)**
|
|
* 🛡️ **Database schema auto-generated from field settings**
|
|
* 📄 **Per-display field rendering config (list/edit)**
|
|
|
|
### 📐 Dynamic GET (Visual SQL Engine)
|
|
|
|
* 📊 **Design complex joins from GUI**
|
|
* 🔄 **Reusable query sets**
|
|
* 🧾 **Where/group/order statements supported**
|
|
* 🔧 **Switch between list/item GETs**
|
|
* 🛡️ **Output Joomla-native query builder logic**
|
|
|
|
### 📁 Snippets, Templates, Layouts, Libraries
|
|
|
|
* 🧠 **Snippets = reusable HTML blocks**
|
|
* 🧩 **Layouts = reusable PHP render templates**
|
|
* 🖼️ **Templates = page-level views linked to custom admin/site views**
|
|
* 📦 **Libraries = JS/CSS assets linked to custom admin/site views**
|
|
* 🌐 **CDN/local toggle for library delivery**
|
|
* 🔧 **Repository push/pull/reset workflow**
|
|
* 📥 **Init snippets/layouts/templates via GUI**
|
|
|
|
### 📚 Documentation & Metadata
|
|
|
|
* 📑 **Markdown + PHPDoc docblock support**
|
|
* 🔄 **Update version history logs per entity**
|
|
* 📘 **Auto-documented component structure**
|
|
|
|
### 📊 Analytics & Insights
|
|
|
|
* 📈 **Track last build, size, line count, field count**
|
|
* 📁 **Total file/folder/line counters**
|
|
|
|
</details>
|
|
---
|
|
|
|
## 📦 Get Started Now
|
|
|
|
* 🔽 **Download**: [Stable Releases](https://git.vdm.dev/joomla/pkg-component-builder/releases) · [Nightly J6](https://git.vdm.dev/joomla/pkg-component-builder/archive/6.x.zip) · [Nightly J5](https://git.vdm.dev/joomla/pkg-component-builder/archive/5.x.zip) · [Nightly J4](https://git.vdm.dev/joomla/pkg-component-builder/archive/4.x.zip)
|
|
* 📥 **Install**: Use Joomla's extension manager
|
|
* 🐳 **Docker**: Run instantly using the [official JCB Docker images](https://hub.docker.com/r/octoleo/joomengine)
|
|
* 🎓 **Learn**: [Onboarding](https://github.com/joomengine/jcb-documentation/blob/master/english/README.md) · [Documentation](https://github.com/joomengine/jcb-documentation/blob/master/english/index.md)
|
|
|
|
---
|
|
|
|
## 🤝 Get Help & Join the Community
|
|
|
|
* 💬 [GitHub Discussions](https://github.com/orgs/joomengine/discussions)
|
|
* 🐛 [Report Issues](https://git.vdm.dev/joomla/Component-Builder/issues)
|
|
* 📚 [JCB Documentation](https://github.com/joomengine/jcb-documentation/blob/master/english/README.md)
|
|
* 👨🏫 [Video Channel](https://www.youtube.com/@OctoYou) (offical)
|
|
* 🏛️ [Legacy Channel](https://www.youtube.com/@Joomlamount) (outdated)
|
|
* 🔔 [Telegram Groups](https://t.me/jcb_group) · [Announcements](https://t.me/Joomla_component_builder)
|
|
* 📶 [Status](https://status.vdm.dev/status/jcb)
|
|
* 🛡️ [Security Reports](https://www.vdm.io/report-security-issues)
|
|
|
|
---
|
|
|
|
## 🌱 Why It's Free
|
|
|
|
JCB is developed by developers for developers. Its purpose is to democratize high-performance Joomla development by empowering everyone — from solo builders to large teams — to work with clean, scalable, maintainable, and versionable code. This isn't a template generator — it's a full-scale **extension engineering platform**.
|
|
|
|
---
|
|
|
|
## 🧩 Component Metadata
|
|
|
|
* **Company:** [Vast Development Method](https://dev.vdm.io)
|
|
* **Author:** [Llewellyn van der Merwe](mailto:joomla@vdm.io)
|
|
* **Component:** [Component Builder](https://git.vdm.dev/joomla/Component-Builder)
|
|
* **Created:** 30th April, 2015 · **Last Build:** 8th October, 2026 · **Version:** 6.2.0
|
|
* **License:** GNU General Public License version 2 or later; see LICENSE.txt · **Copyright:** Copyright (C) 2015 Vast Development Method. All rights reserved.
|
|
* **Lines:** 1682442 · **Fields:** 2166 · **Files:** 11076 · **Folders:** 984
|
|
|
|
> Generated with [JCB](https://www.joomlacomponentbuilder.com) — The Smartest Way to Build Joomla Extensions.
|
|
|
|
|
|
## Contributors
|
|
This project exists thanks to all the people who contribute to the [Joomla Component Builder Project](https://github.com/joomengine/Joomla-Component-Builder).
|
|
|
|
[](https://github.com/joomengine/Joomla-Component-Builder/graphs/contributors)
|
|
|
|
### Backers
|
|
Thank you to all our backers! 🙏 [[Become a backer](https://opencollective.com/Joomla-Component-Builder#backer)]
|
|
|
|
[](https://opencollective.com/Joomla-Component-Builder#backers)
|
|
|
|
### Sponsors
|
|
Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/Joomla-Component-Builder#sponsor)]
|
|
|
|
[](https://opencollective.com/Joomla-Component-Builder/sponsor/0/website)
|
|
[](https://opencollective.com/Joomla-Component-Builder/sponsor/1/website)
|
|
[](https://opencollective.com/Joomla-Component-Builder/sponsor/2/website)
|
|
[](https://opencollective.com/Joomla-Component-Builder/sponsor/3/website)
|
|
[](https://opencollective.com/Joomla-Component-Builder/sponsor/4/website)
|
|
[](https://opencollective.com/Joomla-Component-Builder/sponsor/5/website)
|
|
[](https://opencollective.com/Joomla-Component-Builder/sponsor/6/website)
|
|
[](https://opencollective.com/Joomla-Component-Builder/sponsor/7/website)
|
|
[](https://opencollective.com/Joomla-Component-Builder/sponsor/8/website)
|
|
[](https://opencollective.com/Joomla-Component-Builder/sponsor/9/website)
|
|
[](https://opencollective.com/Joomla-Component-Builder/sponsor/10/website)
|
|
[](https://opencollective.com/Joomla-Component-Builder/sponsor/11/website)
|
|
[](https://opencollective.com/Joomla-Component-Builder/sponsor/12/website)
|
|
[](https://opencollective.com/Joomla-Component-Builder/sponsor/13/website)
|
|
[](https://opencollective.com/Joomla-Component-Builder/sponsor/14/website)
|
|
[](https://opencollective.com/Joomla-Component-Builder/sponsor/15/website)
|
|
[](https://opencollective.com/Joomla-Component-Builder/sponsor/16/website)
|
|
[](https://opencollective.com/Joomla-Component-Builder/sponsor/17/website)
|
|
[](https://opencollective.com/Joomla-Component-Builder/sponsor/18/website)
|
|
[](https://opencollective.com/Joomla-Component-Builder/sponsor/19/website)
|
|
[](https://opencollective.com/Joomla-Component-Builder/sponsor/20/website) |