-Come on buy VDM a coffee :)
- * PayPal: [paypal.me/asseblief](https://www.paypal.me/asseblief) (Asseblief = Please) in Afrikaans
- * Bitcoin: 18vURxYpPFjvNk8BnUy1ovCAyQmY3MzkSf
- * Ethereum: 0x9548144662b47327c954f3e214edb96662d51218
\ No newline at end of file
+### Backers
+Thank you to all our backers! 🙏 [[Become a backer](https://opencollective.com/Joomla-Component-Builder#backer)]
+
+
+### 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)]
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/admin/README.txt b/admin/README.txt
index dd42ce373..a99bbee28 100644
--- a/admin/README.txt
+++ b/admin/README.txt
@@ -1,5 +1,7 @@
-# Joomla Component Builder (JCB)
+# Joomla Component Builder ([JCB](http://joomlacomponentbuilder.com))
[](https://github.com/vdm-io/Joomla-Component-Builder/releases) [](https://github.com/vdm-io/Joomla-Component-Builder/releases)
+[](#backers)
+[](#sponsors)
This is a [Joomla 3.x](https://extensions.joomla.org/extension/component-builder/) component. [__See In Action__](https://www.youtube.com/watch?v=IQfsLYIeblk&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&index=45)
@@ -9,29 +11,36 @@ The Component Builder for [Joomla](https://extensions.joomla.org/extension/compo
Whether you're a seasoned [Joomla](https://extensions.joomla.org/extension/component-builder/) developer, or have just started, Component Builder will safe you lots of time and money. A real must have!
-You can install it quite easily and with no limitations. On [github](https://github.com/vdm-io/Joomla-Component-Builder/releases) is the latest release (2.9.7) with **ALL** its features and **ALL** concepts totally open-source and free!
+You can install it quite easily and with no limitations. On [github](https://github.com/vdm-io/Joomla-Component-Builder/releases) is the latest release (2.9.8) with **ALL** its features and **ALL** concepts totally open-source and free!
> Watch Quick Build of a Hello World component in [JCB on Youtube](https://www.youtube.com/watch?v=IQfsLYIeblk&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&index=45)
-Once installed upgrades are quick and easy via the default Joomla upgrade area.
+Once installed upgrades are quick and easy via the default [Joomla](https://extensions.joomla.org/extension/component-builder/) upgrade area.
Some of the Features
====================
++ Fetch Code from IDE and place it back in component during next compilation.
++ Add [Joomla custom fields](https://www.youtube.com/watch?v=n5RBmP0uNCM&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=0s&index=75) in any of your components.
++ Add you [own dashboard](https://www.youtube.com/watch?v=tU7TeYn1Djo&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&index=60) in the back-end.
++ [Dynamic File and Folder](https://www.youtube.com/watch?v=_c7wzW075lA&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=0s&index=56) Inclusion concept.
++ [Easy Translation](https://www.youtube.com/watch?v=q5NwKGnOHoQ&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=0s&index=51) via excel.
++ Adding your [own rule validation](https://www.youtube.com/watch?v=Z6-ggKtX35o&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=0s&index=46) to a field in [JCB](http://joomlacomponentbuilder.com)
++ [Automated backup system](https://www.youtube.com/watch?v=GUWZaODo_IM&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&t=0s&index=40) in [JCB](http://joomlacomponentbuilder.com).
+ Adding mySQL Dump to any View/Table.
+ Grab existing Table data and build a dynamic dump.
-+ Unlimited Joomla Components.
++ Unlimited [Joomla](https://extensions.joomla.org/extension/component-builder/) Components.
+ Unlimited Tables/Views.
+ Reusing Views and Fields.
-+ Runs on Your Own Joomla Install.
++ Runs on Your Own [Joomla](https://extensions.joomla.org/extension/component-builder/) Install.
+ Add Dynamic/custom back-end views that uses Table and Chart result sets.
+ Build data query of extreme complex nature to use in Dynamic/custom views.
+ Highly Dynamic/custom Front-end Structures.
+ Dynamically setup templates and layouts for Front-end design.
+ Integration of the excellent UIKIT lib.
+ Integration of the excellent FOOTABLE lib.
-+ All Joomla Standard Field Types (including repeatable fields).
-+ Strong Implementation of all Joomla Form Security.
++ All [Joomla](https://extensions.joomla.org/extension/component-builder/) Standard Field Types (including subforms).
++ Strong Implementation of all [Joomla](https://extensions.joomla.org/extension/component-builder/) Form Security.
+ Load data via ajax with ease.
+ You can add an Update Server to Components you build.
+ Build advanced Dynamic front-end forms.
@@ -40,13 +49,13 @@ Some of the Features
+ Include any amount of custom files and folders during build.
+ Static helper class with smart methods already included.
+ Static helper methods Can easily be added.
-+ Direct install from complier view.
-+ Integrative with native Joomla Categories and Tags.
++ Direct install from compiler view.
++ Integrative with native [Joomla](https://extensions.joomla.org/extension/component-builder/) Categories and Tags.
+ Fully Dynamic Search Friendly URL Auto Implementation.
+ Custom scripting options all over the MVC structure.
+ Permission implementation down to each view, item and field.
+ Easy extendible to include other libraries.
-+ Can include SQL and visioning update link to distribute your component updates via Joomla default upgrade of components.
++ Can include SQL and visioning update link to distribute your component updates via [Joomla](https://extensions.joomla.org/extension/component-builder/) default upgrade of components.
+ Easy Export & Import addon to all backend-tables.
+ Overriding ability of import concepts in all backend-tables.
+ The Batch and Filter implementation on all backend-list views.
@@ -55,8 +64,8 @@ Some of the Features
Just Imagine
====================
-+ Your Component Back-end can be more advanced then the Joomla Article Manager.
-+ Your Code as Perfectly Unified to the strict Joomla Standards.
++ Your Component Back-end can be more advanced then the [Joomla](https://extensions.joomla.org/extension/component-builder/) Article Manager.
++ Your Code as Perfectly Unified to the strict [Joomla](https://extensions.joomla.org/extension/component-builder/) Standards.
+ Adding Custom Scripting almost anywhere in the MVC structure.
+ Import and export feature to all backend-views.
+ Batch copy and move/update feature for all backend-views.
@@ -76,13 +85,13 @@ You are in Control
+ You can dynamically add internal help structures to all component.
+ There is no limitations on how big or how much you want to build (server limitation only).
+ This is a complete factory kind of component that functions like a deployment hub.
-+ Export any component completely mapped in JCB and import into another JCB.
++ Export any component completely mapped in [JCB](http://joomlacomponentbuilder.com) and import into another [JCB](http://joomlacomponentbuilder.com).
+ This and much much more are all possible with this component builder!
Get More Demo Content
====================
-> The cat is out of the bag, JCB fully mapped can now be yours! Including many other JCB mapped components.
+> The cat is out of the bag, [JCB](http://joomlacomponentbuilder.com) fully mapped can now be yours! Including many other [JCB](http://joomlacomponentbuilder.com) mapped components.
### All you need to do is [explained here](https://vdm.bz/how-to-get-free-vdm-package-keys)!
@@ -95,37 +104,38 @@ Where can you get support and help?
+ [The JCB Tutorials](https://www.youtube.com/playlist?list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE)
+ [Hello World Tutorial](https://www.youtube.com/watch?v=IQfsLYIeblk&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&index=45)
+ [The JCB! Wiki](https://github.com/vdm-io/Joomla-Component-Builder/wiki)
-+ [JCB Google Group/forum](https://groups.google.com/a/vdm.io/d/forum/jcb)
++ [JCB Google Group/forum](https://vdm.bz/jcb-forum)
+ [Report a Security Issue](http://joomlacomponentbuilder.com/report-security-issues)
+ [Community Complaint](http://joomlacomponentbuilder.com/community-complaint)
+ [Open Issue On Github](https://github.com/vdm-io/Joomla-Component-Builder/issues) ^^
++ [JCB IRC Channel](https://vdm.bz/jcb-irc)
-Since JCB has [become a community](https://github.com/vdm-io/Joomla-Component-Builder/blob/staging/.github/SUPPORT.md) project [VDM.io](https://www.vdm.io/) is **no longer solely responsible** for support.
+Since [JCB](http://joomlacomponentbuilder.com) has [become a community](https://github.com/vdm-io/Joomla-Component-Builder/blob/staging/.github/SUPPORT.md) project [VDM.io](https://www.vdm.io/) is **no longer solely responsible** for support.
-We have started a [**JCB forum**](https://groups.google.com/a/vdm.io/d/forum/jcb) where you can post questions, about how things work, or if you need some kind of help in relation to your development of your components.
+We have started a [**JCB forum**](https://vdm.bz/jcb-forum) where you can post questions, about how things work, or if you need some kind of help in relation to your development of your components.
-^^ Then if you run into any issues, related to the JCB code, like bugs, **start by searching** the (*open & closed*) issues over on Github, and if the issue has not been mentioned before, **then only** open a new issue, following the [community guidelines](https://github.com/vdm-io/Joomla-Component-Builder/blob/master/.github/CONTRIBUTING.md).
+^^ Then if you run into any issues, related to the [JCB](http://joomlacomponentbuilder.com) code, like bugs, **start by searching** the (*open & closed*) issues over on Github, and if the issue has not been mentioned before, **then only** open a new issue, following the [community guidelines](https://github.com/vdm-io/Joomla-Component-Builder/blob/master/.github/CONTRIBUTING.md).
WHY GIVE IT AWAY LIKE THIS?
====================
> We are Open Source Enthusiast
-> Who Support the Joomla Community
+> Who Support the [Joomla](https://extensions.joomla.org/extension/component-builder/) Community
Our idea was to almost let this tool serve as a cheat sheet to how things can be done... and with the help of other developers end up formulating the way how things not only can, but must be done to insure secure, stable, scalable and maintainable code is produced.
MAKING IT BETTER!
====================
-Get involved on the forums, and the GitHub issues, and you can even help us develop/improve the pipeline of JCB for continues delivery. We really want to see JCB remain the tool of choice for all Joomla Component Development needs and ideas.
+Get involved on the forums, and the GitHub issues, and you can even help us develop/improve the pipeline of [JCB](http://joomlacomponentbuilder.com) for continues delivery. We really want to see [JCB](http://joomlacomponentbuilder.com) remain the tool of choice for all [Joomla Component Development](https://extensions.joomla.org/extension/component-builder/) needs and ideas.
TODO
======
-- Add automatic (REST) API ability for all components build with JCB. So we can link any component build with JCB to an Android/Apple APP.
-- Add automatic unit testing. To nurture pipeline integration for all components build with JCB.
-- Team collaborative development across JCB installations offline and online.
-- Documentation (maintained by the community) for JCB. (help us select the best system for this)
+- Add automatic (REST) API ability for all components build with [JCB](http://joomlacomponentbuilder.com). So we can link any component build with JCB to an Android/Apple APP.
+- Add automatic unit testing. To nurture pipeline integration for all components build with [JCB](http://joomlacomponentbuilder.com).
+- Team collaborative development across [JCB](http://joomlacomponentbuilder.com) installations offline and online.
+- Documentation (maintained by the community) for [JCB](http://joomlacomponentbuilder.com). (help us select the best system for this)
# Build Details
@@ -133,21 +143,35 @@ TODO
+ *Author*: [Llewellyn van der Merwe](mailto:llewellyn@joomlacomponentbuilder.com)
+ *Name*: [Component Builder](https://github.com/vdm-io/Joomla-Component-Builder)
+ *First Build*: 30th April, 2015
-+ *Last Build*: 27th November, 2018
-+ *Version*: 2.9.7
++ *Last Build*: 19th December, 2018
++ *Version*: 2.9.8
+ *Copyright*: Copyright (C) 2015 - 2018 Vast Development Method. All rights reserved.
+ *License*: GNU General Public License version 2 or later; see LICENSE.txt
-+ *Line count*: **195519**
++ *Line count*: **195554**
+ *Field count*: **1087**
+ *File count*: **1275**
+ *Folder count*: **201**
-> This **component** was build with a Joomla [Automated Component Builder](http://joomlacomponentbuilder.com).
+> This **component** was build with a [Joomla](https://extensions.joomla.org/extension/component-builder/) [Automated Component Builder](http://joomlacomponentbuilder.com).
> Developed by [Llewellyn van der Merwe](mailto:llewellyn@joomlacomponentbuilder.com)
-## Donations
+## Contributors
+This project exists thanks to all the people who contribute.
+
-Come on buy VDM a coffee :)
- * PayPal: [paypal.me/asseblief](https://www.paypal.me/asseblief) (Asseblief = Please) in Afrikaans
- * Bitcoin: 18vURxYpPFjvNk8BnUy1ovCAyQmY3MzkSf
- * Ethereum: 0x9548144662b47327c954f3e214edb96662d51218
\ No newline at end of file
+### Backers
+Thank you to all our backers! 🙏 [[Become a backer](https://opencollective.com/Joomla-Component-Builder#backer)]
+
+
+### 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)]
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/admin/compiler/joomla_3/Helper.php b/admin/compiler/joomla_3/Helper.php
index 854e96267..2841876b0 100644
--- a/admin/compiler/joomla_3/Helper.php
+++ b/admin/compiler/joomla_3/Helper.php
@@ -23,7 +23,7 @@ defined('_JEXEC') or die('Restricted access');
abstract class ###Component###Helper
{###ADMIN_GLOBAL_EVENT_HELPER######CUSTOM_HELPER_SCRIPT######BOTH_CUSTOM_HELPER_SCRIPT###
/**
- * Load the Component xml manifest.
+ * Load the Component xml manifest.
**/
public static function manifest()
{
@@ -32,12 +32,12 @@ abstract class ###Component###Helper
}
/**
- * Joomla version object
+ * Joomla version object
**/
protected static $JVersion;
/**
- * set/get Joomla version
+ * set/get Joomla version
**/
public static function jVersion()
{
@@ -50,7 +50,7 @@ abstract class ###Component###Helper
}
/**
- * Load the Contributors details.
+ * Load the Contributors details.
**/
public static function getContributors()
{
@@ -88,7 +88,7 @@ abstract class ###Component###Helper
}###HELP###
/**
- * Configure the Linkbar.
+ * Configure the Linkbar.
**/
public static function addSubmenu($submenu)
{
@@ -494,7 +494,7 @@ abstract class ###Component###Helper
}
/**
- * Get any component's model
+ * Get any component's model
**/
public static function getModel($name, $path = JPATH_COMPONENT_ADMINISTRATOR, $component = '###Component###', $config = array())
{
@@ -538,9 +538,9 @@ abstract class ###Component###Helper
}
/**
- * Add to asset Table
+ * Add to asset Table
*/
- public static function setAsset($id,$table)
+ public static function setAsset($id, $table, $inherit = true)
{
$parent = JTable::getInstance('Asset');
$parent->loadByName('com_###component###');
@@ -572,7 +572,7 @@ abstract class ###Component###Helper
$asset->name = $name;
$asset->title = $title;
// get the default asset rules
- $rules = self::getDefaultAssetRules('com_###component###',$table);
+ $rules = self::getDefaultAssetRules('com_###component###', $table, $inherit);
if ($rules instanceof JAccessRules)
{
$asset->rules = (string) $rules;
@@ -600,55 +600,62 @@ abstract class ###Component###Helper
}
/**
- * Gets the default asset Rules for a component/view.
+ * Gets the default asset Rules for a component/view.
*/
- protected static function getDefaultAssetRules($component,$view)
+ protected static function getDefaultAssetRules($component, $view, $inherit = true)
{
- // Need to find the asset id by the name of the component.
- $db = JFactory::getDbo();
- $query = $db->getQuery(true)
- ->select($db->quoteName('id'))
- ->from($db->quoteName('#__assets'))
- ->where($db->quoteName('name') . ' = ' . $db->quote($component));
- $db->setQuery($query);
- $db->execute();
- if ($db->loadRowList())
+ // if new or inherited
+ $assetId = 0;
+ // Only get the actual item rules if not inheriting
+ if (!$inherit)
{
- // asset alread set so use saved rules
- $assetId = (int) $db->loadResult();
- $result = JAccess::getAssetRules($assetId);
- if ($result instanceof JAccessRules)
+ // Need to find the asset id by the name of the component.
+ $db = JFactory::getDbo();
+ $query = $db->getQuery(true)
+ ->select($db->quoteName('id'))
+ ->from($db->quoteName('#__assets'))
+ ->where($db->quoteName('name') . ' = ' . $db->quote($component));
+ $db->setQuery($query);
+ $db->execute();
+ // check that there is a value
+ if ($db->getNumRows())
{
- $_result = (string) $result;
- $_result = json_decode($_result);
- foreach ($_result as $name => &$rule)
- {
- $v = explode('.', $name);
- if ($view !== $v[0])
- {
- // remove since it is not part of this view
- unset($_result->$name);
- }
- else
- {
- // clear the value since we inherit
- $rule = array();
- }
- }
- // check if there are any view values remaining
- if (count((array)$_result))
- {
- $_result = json_encode($_result);
- $_result = array($_result);
- // Instantiate and return the JAccessRules object for the asset rules.
- $rules = new JAccessRules($_result);
-
- return $rules;
- }
- return $result;
+ // asset already set so use saved rules
+ $assetId = (int) $db->loadResult();
}
}
- return JAccess::getAssetRules(0);
+ // get asset rules
+ $result = JAccess::getAssetRules($assetId);
+ if ($result instanceof JAccessRules)
+ {
+ $_result = (string) $result;
+ $_result = json_decode($_result);
+ foreach ($_result as $name => &$rule)
+ {
+ $v = explode('.', $name);
+ if ($view !== $v[0])
+ {
+ // remove since it is not part of this view
+ unset($_result->$name);
+ }
+ elseif ($inherit)
+ {
+ // clear the value since we inherit
+ $rule = array();
+ }
+ }
+ // check if there are any view values remaining
+ if (count($_result))
+ {
+ $_result = json_encode($_result);
+ $_result = array($_result);
+ // Instantiate and return the JAccessRules object for the asset rules.
+ $rules = new JAccessRules($_result);
+ // return filtered rules
+ return $rules;
+ }
+ }
+ return $result;
}
/**
@@ -817,11 +824,11 @@ abstract class ###Component###Helper
}
/**
- * Check if have an json string
+ * Check if have an json string
*
- * @input string The json string to check
+ * @input string The json string to check
*
- * @returns bool true on success
+ * @returns bool true on success
**/
public static function checkJson($string)
{
@@ -834,11 +841,11 @@ abstract class ###Component###Helper
}
/**
- * Check if have an object with a length
+ * Check if have an object with a length
*
- * @input object The object to check
+ * @input object The object to check
*
- * @returns bool true on success
+ * @returns bool true on success
**/
public static function checkObject($object)
{
@@ -850,11 +857,11 @@ abstract class ###Component###Helper
}
/**
- * Check if have an array with a length
+ * Check if have an array with a length
*
- * @input array The array to check
+ * @input array The array to check
*
- * @returns bool/int number of items in array on success
+ * @returns bool/int number of items in array on success
**/
public static function checkArray($array, $removeEmptyString = false)
{
@@ -878,11 +885,11 @@ abstract class ###Component###Helper
}
/**
- * Check if have a string with a length
+ * Check if have a string with a length
*
- * @input string The string to check
+ * @input string The string to check
*
- * @returns bool true on success
+ * @returns bool true on success
**/
public static function checkString($string)
{
@@ -894,10 +901,10 @@ abstract class ###Component###Helper
}
/**
- * Check if we are connected
- * Thanks https://stackoverflow.com/a/4860432/1429677
+ * Check if we are connected
+ * Thanks https://stackoverflow.com/a/4860432/1429677
*
- * @returns bool true on success
+ * @returns bool true on success
**/
public static function isConnected()
{
@@ -919,11 +926,11 @@ abstract class ###Component###Helper
}
/**
- * Merge an array of array's
+ * Merge an array of array's
*
- * @input array The arrays you would like to merge
+ * @input array The arrays you would like to merge
*
- * @returns array on success
+ * @returns array on success
**/
public static function mergeArrays($arrays)
{
@@ -949,11 +956,11 @@ abstract class ###Component###Helper
}
/**
- * Shorten a string
+ * Shorten a string
*
- * @input string The you would like to shorten
+ * @input string The you would like to shorten
*
- * @returns string on success
+ * @returns string on success
**/
public static function shorten($string, $length = 40, $addTip = true)
{
@@ -990,11 +997,11 @@ abstract class ###Component###Helper
}
/**
- * Making strings safe (various ways)
+ * Making strings safe (various ways)
*
- * @input string The you would like to make safe
+ * @input string The you would like to make safe
*
- * @returns string on success
+ * @returns string on success
**/
public static function safeString($string, $type = 'L', $spacer = '_', $replaceNumbers = true, $keepOnlyCharacters = true)
{
@@ -1134,11 +1141,11 @@ abstract class ###Component###Helper
}
/**
- * Convert an integer into an English word string
- * Thanks to Tom Nicholson [save to see placeholder]
You can also pass values to this code like this: [save to see placeholder trick]
Those values will be replace placeholders called args. These placeholders are zero based and should look like this: [[[arg0]]], [[[arg1]]] ... as many as you like. If you use 5 args in your code, you must always pass 5 values, since they are zero based your fifth arg will look like this [[[arg4]]]
To use the following [ ] , + = in your string being passed, use the following: [ ⇒ [; ] ⇒ ]; , ⇒ ,; + ⇒ +; = ⇒ =
Please note that you can not use this placeholder in other custom code views, but in all other custom code areas in JCB found in other views like the admin, site and custom admin views.
Another important note, all code with args will not be reversed updated from the changes in the editor out side of JCB at this time, since that will remove all the arg placeholders this means you will only be able to update the code here in the JCB UI.
Please note THAT YOU CAN NOW use this placeholder in other custom code views, just not in Hash (automation) custom code from the IDE, and not in it self, enjoy!
Another important note, all code with args will not be reversed updated from the changes in the editor out side of JCB at this time, since that will remove all the arg placeholders this means you will only be able to update the code here in the JCB UI.