joomla-fieldtypes/README.md

105 lines
15 KiB
Markdown
Raw Normal View History

2024-08-23 16:34:04 +00:00
```
██╗ ██████╗ ██████╗ ███╗ ███╗██╗ █████╗
██║██╔═══██╗██╔═══██╗████╗ ████║██║ ██╔══██╗
██║██║ ██║██║ ██║██╔████╔██║██║ ███████║
██ ██║██║ ██║██║ ██║██║╚██╔╝██║██║ ██╔══██║
╚█████╔╝╚██████╔╝╚██████╔╝██║ ╚═╝ ██║███████╗██║ ██║
╚════╝ ╚═════╝ ╚═════╝ ╚═╝ ╚═╝╚══════╝╚═╝ ╚═╝
███████╗██╗███████╗██╗ ██████╗ ████████╗██╗ ██╗██████╗ ███████╗███████╗
██╔════╝██║██╔════╝██║ ██╔══██╗ ╚══██╔══╝╚██╗ ██╔╝██╔══██╗██╔════╝██╔════╝
█████╗ ██║█████╗ ██║ ██║ ██║ ██║ ╚████╔╝ ██████╔╝█████╗ ███████╗
██╔══╝ ██║██╔══╝ ██║ ██║ ██║ ██║ ╚██╔╝ ██╔═══╝ ██╔══╝ ╚════██║
██║ ██║███████╗███████╗██████╔╝ ██║ ██║ ██║ ███████╗███████║
╚═╝ ╚═╝╚══════╝╚══════╝╚═════╝ ╚═╝ ╚═╝ ╚═╝ ╚══════╝╚══════╝
```
### What is JCB Joomla Field Types?
The Joomla field types provide a powerful way to map Joomla-related field types, enabling seamless integration with Joomla Component Builder (JCB). This repository serves as a centralized system for maintaining, updating, and distributing these field types throughout the JCB ecosystem.
When you need to update any field type in JCB, simply select the desired field type and click the "reset" button. This action will automatically sync the selected field type with its corresponding version hosted in our core repository, ensuring you always have the latest updates.
Moreover, if you wish to tailor the field types to your specific needs, you can fork the repository and point your JCB instance to your fork. This allows you to maintain and update field types independently from the main JCB community, offering the flexibility that is at the heart of open-source philosophy.
We believe this approach empowers you to extend and customize JCB to fit your unique requirements, exemplifying the true spirit of freedom in software development. We trust you will find this capability both useful and aligned with the expectations of how open-source software should function.
# Index of Joomla! Field Types
2024-08-23 17:25:43 +00:00
- **Accesslevel** | [Details](src/913ed2ce-836c-48e8-97af-e482441f47df) | [Settings](src/913ed2ce-836c-48e8-97af-e482441f47df/item.json) | List of accesslevels
2024-08-23 16:34:04 +00:00
- **Calendar** | [Details](src/6cf5a33f-cb25-4a58-bfec-7e1511896402) | [Settings](src/6cf5a33f-cb25-4a58-bfec-7e1511896402/item.json) | provides a text box for entry of a date. An icon next to the text box provides a link to a pop-up calendar, which can also be used to enter the date value.
2024-08-23 17:25:43 +00:00
- **Captcha** | [Details](src/206fdad4-14d0-45f1-9c84-3d09abf48a39) | [Settings](src/206fdad4-14d0-45f1-9c84-3d09abf48a39/item.json) | Captcha robot check.
2024-08-23 16:35:55 +00:00
- **Category** | [Details](src/f70346b3-2096-4f44-8b26-01ab87da7d1e) | [Settings](src/f70346b3-2096-4f44-8b26-01ab87da7d1e/item.json) | provides a drop down list of categories for an extension.
2024-08-23 17:25:43 +00:00
- **Checkbox** | [Details](src/10066262-b6e3-4f82-941e-cbe4f61ddd6c) | [Settings](src/10066262-b6e3-4f82-941e-cbe4f61ddd6c/item.json) | provides a single checkbox to be checked or unchecked
- **Checkboxes** | [Details](src/ac10859b-58da-4584-9682-36a6c2c8d04d) | [Settings](src/ac10859b-58da-4584-9682-36a6c2c8d04d/item.json) | provides unlimited checkboxes that can be used for multi-select.
- **Color** | [Details](src/7f60f198-53e7-4fe9-813f-d1b6c553680e) | [Settings](src/7f60f198-53e7-4fe9-813f-d1b6c553680e/item.json) | provides a color picker when clicking the input box.
- **Combo** | [Details](src/2c8b128f-7da2-4f55-b1d7-3613f902f590) | [Settings](src/2c8b128f-7da2-4f55-b1d7-3613f902f590/item.json) | Provides a combobox list field, allows free text.
- **Custom** | [Details](src/dd2e1f4b-f5db-45e8-85fa-efd27bae7b6a) | [Settings](src/dd2e1f4b-f5db-45e8-85fa-efd27bae7b6a/item.json) | provides a drop down list of items entries.
- **CustomUser** | [Details](src/a4a39f70-070f-459c-be4b-0ac103a29b9a) | [Settings](src/a4a39f70-070f-459c-be4b-0ac103a29b9a/item.json) | Provides list of users.
- **DynamicCheckboxes@** | [Details](src/7ed21e79-cbc5-48e3-9ed0-ca72b0f2f1a1) | [Settings](src/7ed21e79-cbc5-48e3-9ed0-ca72b0f2f1a1/item.json) | Super Power Repository Paths
- **Editor** | [Details](src/51f288d2-6eaa-42bc-a182-a6f69b3032b8) | [Settings](src/51f288d2-6eaa-42bc-a182-a6f69b3032b8/item.json) | provides an editor area field.
- **Email** | [Details](src/35948af5-9e79-4454-8dfa-682ee4fdf650) | [Settings](src/35948af5-9e79-4454-8dfa-682ee4fdf650/item.json) | Email form field type
- **File** | [Details](src/6da71c1e-119c-4e0d-a309-f3e52ecfa1d1) | [Settings](src/6da71c1e-119c-4e0d-a309-f3e52ecfa1d1/item.json) | Provides an input field for files
- **Filelist** | [Details](src/0c80df15-52c6-4647-983b-4bb4888a2edf) | [Settings](src/0c80df15-52c6-4647-983b-4bb4888a2edf/item.json) | Provides a drop down list of files from a specified directory.
- **Folderlist** | [Details](src/d3ab2ae4-9370-4497-ae6d-dee2e0b74b7a) | [Settings](src/d3ab2ae4-9370-4497-ae6d-dee2e0b74b7a/item.json) | Provides a drop down list of folders from a specified directory.
- **Groupedlist** | [Details](src/088d47c0-b058-4894-b92e-dcf1b9d5a722) | [Settings](src/088d47c0-b058-4894-b92e-dcf1b9d5a722/item.json) | provides a drop down list of custom-defined entries.
- **Hidden** | [Details](src/82f1b5ca-bb9b-44d7-9a7a-9a03fb2a31dd) | [Settings](src/82f1b5ca-bb9b-44d7-9a7a-9a03fb2a31dd/item.json) | provides a hidden field for saving a form field whose value cannot be altered directly by a user.
- **Imagelist** | [Details](src/72680e92-2859-49c6-ad92-c2329c52f9f8) | [Settings](src/72680e92-2859-49c6-ad92-c2329c52f9f8/item.json) | Provides a drop down list of image files from a specified directory.
- **Integer** | [Details](src/fdbb50ea-35d2-45b2-a0bc-076fdf1544b8) | [Settings](src/fdbb50ea-35d2-45b2-a0bc-076fdf1544b8/item.json) | provides a drop down list of integers between a minimum and maximum.
- **List** | [Details](src/a51dfc06-1b9b-4d0a-86ba-f705bcd40d4d) | [Settings](src/a51dfc06-1b9b-4d0a-86ba-f705bcd40d4d/item.json) | provides a drop down list of custom-defined entries.
- **Media** | [Details](src/69957007-e3d4-4976-a32b-611d02dbad71) | [Settings](src/69957007-e3d4-4976-a32b-611d02dbad71/item.json) | provides modal access to the media manager for insertion of images with upload for users with appropriate permissions.
- **Menu** | [Details](src/6349f152-8ef5-43bd-a89b-ce18f33ac5e5) | [Settings](src/6349f152-8ef5-43bd-a89b-ce18f33ac5e5/item.json) | Menu Type
- **Meter** | [Details](src/81668284-e572-4e17-927b-ba697fc64bd0) | [Settings](src/81668284-e572-4e17-927b-ba697fc64bd0/item.json) | Provides a meter to show value in a range.
- **Modal Menu** | [Details](src/715256a4-8cc2-4d66-9d08-31e58ca5b036) | [Settings](src/715256a4-8cc2-4d66-9d08-31e58ca5b036/item.json) | Modal Menu
- **Modulelayout** | [Details](src/7520c8f4-543d-4c7a-8e4f-e2da71c3b1cd) | [Settings](src/7520c8f4-543d-4c7a-8e4f-e2da71c3b1cd/item.json) | modulelayout
- **Note** | [Details](src/f9ecacd0-8481-4157-8c71-d7aaefc2b7c3) | [Settings](src/f9ecacd0-8481-4157-8c71-d7aaefc2b7c3/item.json) | supports a one line text field.
- **Number** | [Details](src/5abd2b73-643b-4273-841a-787991aad968) | [Settings](src/5abd2b73-643b-4273-841a-787991aad968/item.json) | Provides a one line text box with up-down handles to set a number in the field.
- **Password** | [Details](src/0022598d-0ee1-44f2-aa94-c2eb47595f73) | [Settings](src/0022598d-0ee1-44f2-aa94-c2eb47595f73/item.json) | provides a text box for entry of a password. The password characters will be obscured as they are entered.
- **Plugins** | [Details](src/37fa4e1d-b7ca-4a8f-aa4b-d8085c135233) | [Settings](src/37fa4e1d-b7ca-4a8f-aa4b-d8085c135233/item.json) | Provides a dropdown list of plugin options from the folder.
- **Privacy@** | [Details](src/60c1d674-8bb7-4b31-97ed-ee1f16bc412a) | [Settings](src/60c1d674-8bb7-4b31-97ed-ee1f16bc412a/item.json) | Joomla Privacy Field
- **Radio** | [Details](src/b868ed59-4208-4206-8504-95a35a74a11c) | [Settings](src/b868ed59-4208-4206-8504-95a35a74a11c/item.json) | provides radio buttons to select different options.
- **Range** | [Details](src/627d3845-7273-4f75-8e63-7b3a319a42c8) | [Settings](src/627d3845-7273-4f75-8e63-7b3a319a42c8/item.json) | Provides a horizontal scroll bar to specify a value in a range.
- **Repeatable** | [Details](src/05bf68d4-52f9-4705-8ae7-cba137fce0ad) | [Settings](src/05bf68d4-52f9-4705-8ae7-cba137fce0ad/item.json) | Allows form fields which can have as many options as the user desires.
- **SQL** | [Details](src/d4c16f1e-fd6e-4714-90eb-f9d97edd9c32) | [Settings](src/d4c16f1e-fd6e-4714-90eb-f9d97edd9c32/item.json) | provides a drop down list of entries obtained by running a query on the Joomla Database. The first results column returned by the query provides the values for the drop down box.
- **Spacer** | [Details](src/626d0cba-a908-4a4f-a447-96d781aeaa0b) | [Settings](src/626d0cba-a908-4a4f-a447-96d781aeaa0b/item.json) | provides a visual separator between form fields. It is purely a visual aid and no value is stored.
- **Subform** | [Details](src/7139f2c8-a70a-46a6-bbe3-4eefe54ca515) | [Settings](src/7139f2c8-a70a-46a6-bbe3-4eefe54ca515/item.json) | Allows form fields which can have as many options as the user desires.
- **Tag** | [Details](src/48cba89e-8fcb-481e-a7d3-2e41773e452d) | [Settings](src/48cba89e-8fcb-481e-a7d3-2e41773e452d/item.json) | provides an entry point for tags (either AJAX or Nested).
- **Tel** | [Details](src/1c6c519c-3bc8-4914-8940-3e9591b0bce6) | [Settings](src/1c6c519c-3bc8-4914-8940-3e9591b0bce6/item.json) | provides an input field for a telephone number.
- **Terms@** | [Details](src/20e88943-08db-49e6-a571-dba70cdf4cca) | [Settings](src/20e88943-08db-49e6-a571-dba70cdf4cca/item.json) | Joomla Terms Field
- **Text** | [Details](src/201327fe-3067-4316-a155-3fe2a52e05c0) | [Settings](src/201327fe-3067-4316-a155-3fe2a52e05c0/item.json) | provides a text box for data entry.
- **Textarea** | [Details](src/76fe1250-6fa7-49e5-a0ee-f06d8d4c9f99) | [Settings](src/76fe1250-6fa7-49e5-a0ee-f06d8d4c9f99/item.json) | provides a text area for entry of multi-line text.
- **Timezone** | [Details](src/ed8d8cf4-cb05-49cc-95ef-4ef275f539f9) | [Settings](src/ed8d8cf4-cb05-49cc-95ef-4ef275f539f9/item.json) | provides a drop down list of time zones.
- **URL** | [Details](src/8df6e07e-2b16-43ed-a18d-2059fa44cdf1) | [Settings](src/8df6e07e-2b16-43ed-a18d-2059fa44cdf1/item.json) | provides a URL text input field.
- **User** | [Details](src/b0641980-5e78-42f6-972f-86aa607db23e) | [Settings](src/b0641980-5e78-42f6-972f-86aa607db23e/item.json) | provides a modal list of users.
- **Usergrouplist** | [Details](src/e2f31181-fbb3-4c3a-859d-72b6b0cff308) | [Settings](src/e2f31181-fbb3-4c3a-859d-72b6b0cff308/item.json) | provides a drop down list of user groups.
- **menuitem** | [Details](src/f183b0e2-017f-48bd-8dba-d332ce1b8d9e) | [Settings](src/f183b0e2-017f-48bd-8dba-d332ce1b8d9e/item.json) | provides a drop down list of the available menu items from your Joomla site.
2024-08-23 16:34:04 +00:00
---
```
██╗ ██████╗ ██████╗ ███╗ ███╗██╗ █████╗
██║██╔═══██╗██╔═══██╗████╗ ████║██║ ██╔══██╗
██║██║ ██║██║ ██║██╔████╔██║██║ ███████║
██ ██║██║ ██║██║ ██║██║╚██╔╝██║██║ ██╔══██║
╚█████╔╝╚██████╔╝╚██████╔╝██║ ╚═╝ ██║███████╗██║ ██║
╚════╝ ╚═════╝ ╚═════╝ ╚═╝ ╚═╝╚══════╝╚═╝ ╚═╝
██████╗ ██████╗ ███╗ ███╗██████╗ ██████╗ ███╗ ██╗███████╗███╗ ██╗████████╗
██╔════╝██╔═══██╗████╗ ████║██╔══██╗██╔═══██╗████╗ ██║██╔════╝████╗ ██║╚══██╔══╝
██║ ██║ ██║██╔████╔██║██████╔╝██║ ██║██╔██╗ ██║█████╗ ██╔██╗ ██║ ██║
██║ ██║ ██║██║╚██╔╝██║██╔═══╝ ██║ ██║██║╚██╗██║██╔══╝ ██║╚██╗██║ ██║
╚██████╗╚██████╔╝██║ ╚═╝ ██║██║ ╚██████╔╝██║ ╚████║███████╗██║ ╚████║ ██║
╚═════╝ ╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═════╝ ╚═╝ ╚═══╝╚══════╝╚═╝ ╚═══╝ ╚═╝
██████╗ ██╗ ██╗██╗██╗ ██████╗ ███████╗██████╗
██╔══██╗██║ ██║██║██║ ██╔══██╗██╔════╝██╔══██╗
██████╔╝██║ ██║██║██║ ██║ ██║█████╗ ██████╔╝
██╔══██╗██║ ██║██║██║ ██║ ██║██╔══╝ ██╔══██╗
██████╔╝╚██████╔╝██║███████╗██████╔╝███████╗██║ ██║
╚═════╝ ╚═════╝ ╚═╝╚══════╝╚═════╝ ╚══════╝╚═╝ ╚═╝
```
> Build with [Joomla Component Builder](https://git.vdm.dev/joomla/Component-Builder)