I've created a category form field, and added to an admin view. I essentially "copied' what Recipe Manager had. The field is added to the view, but no option is showing on the dashboard for adding a category.
Steps to reproduce the Bug
Create a category field, add to your view, link view to component, then compile and install.
Which Joomla version are you compiling in?
5.3.2
Which PHP version are you compiling in?
8.2.24
Which Joomla versions are you targeting?
5.x
Which PHP version are you targeting?
8.2+
Which Web server is JCB running on?
Apache 2.4.62
Which Relational Database is JCB running on?
11.7.2-MariaDB-ubu2404
Which OS is JCB running on?
Ubuntu 24.04.2
Which JCB version are you using?
5.1.1
Where in JCB did this issue occur?
Dashboard(admin_view)
On which browsers did you encounter the issue?
Firefox
Additional Comments
No response
### What Happened?
I've created a category form field, and added to an admin view. I essentially "copied' what Recipe Manager had. The field is added to the view, but no option is showing on the dashboard for adding a category.
### Steps to reproduce the Bug
Create a category field, add to your view, link view to component, then compile and install.
### Which Joomla version are you compiling in?
5.3.2
### Which PHP version are you compiling in?
8.2.24
### Which Joomla versions are you targeting?
5.x
### Which PHP version are you targeting?
8.2+
### Which Web server is JCB running on?
Apache 2.4.62
### Which Relational Database is JCB running on?
11.7.2-MariaDB-ubu2404
### Which OS is JCB running on?
Ubuntu 24.04.2
### Which JCB version are you using?
5.1.1
### Where in JCB did this issue occur?
Dashboard(admin_view)
### On which browsers did you encounter the issue?
Firefox
### Additional Comments
_No response_
mwweb
added the Bug label 2025-08-17 20:47:42 +00:00
@mwweb I picked this up on the Recipe Manager as well. The Category field's code name SHOULD ALWAYS be catid. It was a issue on the Recipe Manager but we have fixed it and will be pushing out the update soon. But the main thing here is that in Joomla five for the category field to work correctly, using the Joomla categories, it should be catid.
@mwweb I picked this up on the Recipe Manager as well. The Category field's code name SHOULD ALWAYS be `catid`. It was a issue on the Recipe Manager but we have fixed it and will be pushing out the update soon. But the main thing here is that in Joomla five for the category field to work correctly, using the Joomla categories, it should be `catid`.
We have rolled out a new package of the Recipe Manager and all the other components in the package repository and it fixed all known bugs in that components.
To get the latest update simply select to the area you want to update and click the Reset button. This will bring it into sync with the latest updates.
Please note that this will also overwrite any earlier changes made to that area.
We have rolled out a new package of the Recipe Manager and all the other components in the package repository and it fixed all known bugs in that components.
To get the latest update simply select to the area you want to update and click the `Reset` button. This will bring it into sync with the latest updates.
Please note that this will also overwrite any earlier changes made to that area.
Honestly, I think there may be more than just this. I actually had the category showing in the admin view, with something other than catid. However, I did as you suggested and changed the name to catid.
I re-compiled and installed, and there was no change. In Recipe Manager it does show "recipes catid Categories for Recipes" on the Dashboard, but in my testing component, it only shows my admin view, but if I go to add a new view record, it DOES show the category field.
So, I'm at a loss as to the option to add categories in Recipe Manager works and shows on the Dashboard, but doesn't in a test component.
I even made a copy of the category field, added to my test component, and it still didn't do anything.
In addition, I manually added a category in the DB for my test component, and when I went to add a new record, the catid field showed my manually created category. The issue "appears" to be with JCB now always adding the Add Category option on the Dashboard.
Honestly, I think there may be more than just this. I actually had the category showing in the admin view, with something other than catid. However, I did as you suggested and changed the name to catid.
I re-compiled and installed, and there was no change. In Recipe Manager it does show "recipes catid Categories for Recipes" on the Dashboard, but in my testing component, it only shows my admin view, but if I go to add a new view record, it DOES show the category field.
So, I'm at a loss as to the option to add categories in Recipe Manager works and shows on the Dashboard, but doesn't in a test component.
I even made a copy of the category field, added to my test component, and it still didn't do anything.
In addition, I manually added a category in the DB for my test component, and when I went to add a new record, the catid field showed my manually created category. The issue "appears" to be with JCB now always adding the Add Category option on the Dashboard.
I spent some time reviewing files between my component, and the Recipes component. For the most part, they are very similar. But I did find this difference. Not Line 745 and 749 in my component, verses 717 and 721 in the Recipe component.
` C:\temp\com_recipemanager_v5_0_1__J5\admin\src\Model\RecipeModel.php (10 hits)
Line 73: 'catid'
Line 673: $values['catid'] = $values['category'];
Line 715: if (isset($values['catid']))
Line 717: list($this->table->name, $this->table->alias) = $this->generateNewTitle($values['catid'], $this->table->alias, $this->table->name);
Line 721: list($this->table->name, $this->table->alias) = $this->generateNewTitle($this->table->catid, $this->table->alias, $this->table->name);
Line 828: $values['catid'] = $values['category'];
Line 961: list($name, $alias) = $this->generateNewTitle($data['catid'], $data['alias'], $data['name']);
Line 992: if ($table->load(['alias' => $data['alias'], 'catid' => $data['catid']]) && ($table->id != $data['id'] || $data['id'] == 0))
Line 997: list($name, $alias) = $this->generateNewTitle($data['catid'], $data['alias'], $data['name']);
C:\temp\com_mycomponent_v1_0_8__J5\admin\src\Model\myModel.php (10 hits)
Line 71: 'catid'
Line 701: $values['catid'] = $values['category'];
Line 743: if (isset($values['catid']))
Line 745: static::generateTitle((int) $values['catid'], $this->table);
Line 749: static::generateTitle((int) $this->table->catid, $this->table);
Line 856: $values['catid'] = $values['category'];
Line 991: list($title, $alias) = $this->generateNewTitle($data['catid'], $data['alias'], $data['title']);
Line 1022: if ($table->load(['alias' => $data['alias'], 'catid' => $data['catid']]) && ($table->id != $data['id'] || $data['id'] == 0))
Line 1027: list($title, $alias) = $this->generateNewTitle($data['catid'], $data['alias'], $data['title']);
`
I spent some time reviewing files between my component, and the Recipes component. For the most part, they are very similar. But I did find this difference. Not Line 745 and 749 in my component, verses 717 and 721 in the Recipe component.
` C:\temp\com_recipemanager_v5_0_1__J5\admin\src\Model\RecipeModel.php (10 hits)
Line 73: 'catid'
Line 673: $values['catid'] = $values['category'];
Line 715: if (isset($values['catid']))
Line 717: list($this->table->name, $this->table->alias) = $this->generateNewTitle($values['catid'], $this->table->alias, $this->table->name);
Line 721: list($this->table->name, $this->table->alias) = $this->generateNewTitle($this->table->catid, $this->table->alias, $this->table->name);
Line 828: $values['catid'] = $values['category'];
Line 961: list($name, $alias) = $this->generateNewTitle($data['catid'], $data['alias'], $data['name']);
Line 992: if ($table->load(['alias' => $data['alias'], 'catid' => $data['catid']]) && ($table->id != $data['id'] || $data['id'] == 0))
Line 997: list($name, $alias) = $this->generateNewTitle($data['catid'], $data['alias'], $data['name']);
C:\temp\com_mycomponent_v1_0_8__J5\admin\src\Model\myModel.php (10 hits)
Line 71: 'catid'
Line 701: $values['catid'] = $values['category'];
Line 743: if (isset($values['catid']))
Line 745: static::generateTitle((int) $values['catid'], $this->table);
Line 749: static::generateTitle((int) $this->table->catid, $this->table);
Line 856: $values['catid'] = $values['category'];
Line 991: list($title, $alias) = $this->generateNewTitle($data['catid'], $data['alias'], $data['title']);
Line 1022: if ($table->load(['alias' => $data['alias'], 'catid' => $data['catid']]) && ($table->id != $data['id'] || $data['id'] == 0))
Line 1027: list($title, $alias) = $this->generateNewTitle($data['catid'], $data['alias'], $data['title']);
`
OK, this is STILL an UNANSWERED, UNRESOLVED issue after over 4 months, so I'm continuing to address it. Here is a step by step of what I am doing.
Create a field Type=Category, type=category, name=catid. DB= varchar 255 key null
Create Component
OK, this is STILL an UNANSWERED, UNRESOLVED issue after over 4 months, so I'm continuing to address it. Here is a step by step of what I am doing.
1. Create a field Type=Category, type=category, name=catid. DB= varchar 255 key null
2. Create Component
This field enables category assignment for items in your component.
2. Link the Field to the Admin View
Ensure the field is properly linked to the correct Admin View:
3. Critical Step: Dashboard Visibility
To make Categories visible on the Component Administrator dashboard, you must add an icon for the Categories in the view where this Category field is linked:
Important:
If no icon is defined, the Categories manager:
Will NOT appear on the admin dashboard
Will still be fully functional and accessible
4. Adding Categories
Once compiled, categories will be linked to you component:
5. Direct Access
Even without a dashboard icon, Categories remain accessible via the direct URL: http://your.site.path/administrator/index.php?option=com_categories&view=categories&extension=com_YOUR_COMPONENT
This confirms that category integration is active even if the dashboard shortcut is missing.
Summary
Categories are fully supported in JCB
Field + Admin View linking is required
Dashboard visibility depends on defining an icon
Categories always remain accessible via the Joomla Categories manager
That's all there is to Categories integration in JCB - clean, native, and Joomla-standard.
## Categories Integration with JCB
#### 1. Field Configuration
Configure the Categories field as shown below:

This field enables category assignment for items in your component.
#### 2. Link the Field to the Admin View
Ensure the field is properly linked to the correct **Admin View**:

#### 3. **Critical Step: Dashboard Visibility**
To make Categories visible on the Component Administrator dashboard, you **must** add an icon for the Categories in the view where this Category field is linked:

**Important:**
If **no icon is defined**, the Categories manager:
* **Will NOT appear on the admin dashboard**
* **Will still be fully functional and accessible**
#### 4. Adding Categories
Once compiled, categories will be linked to you component:

#### 5. Direct Access
Even without a dashboard icon, Categories remain accessible via the direct URL:
`http://your.site.path/administrator/index.php?option=com_categories&view=categories&extension=com_YOUR_COMPONENT`
This confirms that category integration is active even if the dashboard shortcut is missing.
**Summary**
* Categories are **fully supported** in JCB
* Field + Admin View linking is required
* Dashboard visibility **depends on defining an icon**
* Categories always remain accessible via the Joomla Categories manager
That's all there is to Categories integration in JCB - clean, native, and Joomla-standard.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
What Happened?
I've created a category form field, and added to an admin view. I essentially "copied' what Recipe Manager had. The field is added to the view, but no option is showing on the dashboard for adding a category.
Steps to reproduce the Bug
Create a category field, add to your view, link view to component, then compile and install.
Which Joomla version are you compiling in?
5.3.2
Which PHP version are you compiling in?
8.2.24
Which Joomla versions are you targeting?
5.x
Which PHP version are you targeting?
8.2+
Which Web server is JCB running on?
Apache 2.4.62
Which Relational Database is JCB running on?
11.7.2-MariaDB-ubu2404
Which OS is JCB running on?
Ubuntu 24.04.2
Which JCB version are you using?
5.1.1
Where in JCB did this issue occur?
Dashboard(admin_view)
On which browsers did you encounter the issue?
Firefox
Additional Comments
No response
Screenshots of setup
@mwweb I picked this up on the Recipe Manager as well. The Category field's code name SHOULD ALWAYS be
catid. It was a issue on the Recipe Manager but we have fixed it and will be pushing out the update soon. But the main thing here is that in Joomla five for the category field to work correctly, using the Joomla categories, it should becatid.We have rolled out a new package of the Recipe Manager and all the other components in the package repository and it fixed all known bugs in that components.
To get the latest update simply select to the area you want to update and click the
Resetbutton. This will bring it into sync with the latest updates.Please note that this will also overwrite any earlier changes made to that area.
Honestly, I think there may be more than just this. I actually had the category showing in the admin view, with something other than catid. However, I did as you suggested and changed the name to catid.
I re-compiled and installed, and there was no change. In Recipe Manager it does show "recipes catid Categories for Recipes" on the Dashboard, but in my testing component, it only shows my admin view, but if I go to add a new view record, it DOES show the category field.
So, I'm at a loss as to the option to add categories in Recipe Manager works and shows on the Dashboard, but doesn't in a test component.
I even made a copy of the category field, added to my test component, and it still didn't do anything.
In addition, I manually added a category in the DB for my test component, and when I went to add a new record, the catid field showed my manually created category. The issue "appears" to be with JCB now always adding the Add Category option on the Dashboard.
I spent some time reviewing files between my component, and the Recipes component. For the most part, they are very similar. But I did find this difference. Not Line 745 and 749 in my component, verses 717 and 721 in the Recipe component.
` C:\temp\com_recipemanager_v5_0_1__J5\admin\src\Model\RecipeModel.php (10 hits)
Line 73: 'catid'
Line 673: $values['catid'] = $values['category'];
Line 715: if (isset($values['catid']))
Line 717: list($this->table->name, $this->table->alias) = $this->generateNewTitle($values['catid'], $this->table->alias, $this->table->name);
Line 721: list($this->table->name, $this->table->alias) = $this->generateNewTitle($this->table->catid, $this->table->alias, $this->table->name);
Line 828: $values['catid'] = $values['category'];
Line 961: list($name, $alias) = $this->generateNewTitle($data['catid'], $data['alias'], $data['name']);
Line 992: if ($table->load(['alias' => $data['alias'], 'catid' => $data['catid']]) && ($table->id != $data['id'] || $data['id'] == 0))
Line 997: list($name, $alias) = $this->generateNewTitle($data['catid'], $data['alias'], $data['name']);
C:\temp\com_mycomponent_v1_0_8__J5\admin\src\Model\myModel.php (10 hits)
Line 71: 'catid'
Line 701: $values['catid'] = $values['category'];
Line 743: if (isset($values['catid']))
Line 745: static::generateTitle((int) $values['catid'], $this->table);
Line 749: static::generateTitle((int) $this->table->catid, $this->table);
Line 856: $values['catid'] = $values['category'];
Line 991: list($title, $alias) = $this->generateNewTitle($data['catid'], $data['alias'], $data['title']);
Line 1022: if ($table->load(['alias' => $data['alias'], 'catid' => $data['catid']]) && ($table->id != $data['id'] || $data['id'] == 0))
Line 1027: list($title, $alias) = $this->generateNewTitle($data['catid'], $data['alias'], $data['title']);
`
OK, this is STILL an UNANSWERED, UNRESOLVED issue after over 4 months, so I'm continuing to address it. Here is a step by step of what I am doing.
Categories Integration with JCB
1. Field Configuration
Configure the Categories field as shown below:
This field enables category assignment for items in your component.
2. Link the Field to the Admin View
Ensure the field is properly linked to the correct Admin View:
3. Critical Step: Dashboard Visibility
To make Categories visible on the Component Administrator dashboard, you must add an icon for the Categories in the view where this Category field is linked:
Important:
If no icon is defined, the Categories manager:
4. Adding Categories
Once compiled, categories will be linked to you component:
5. Direct Access
Even without a dashboard icon, Categories remain accessible via the direct URL:
http://your.site.path/administrator/index.php?option=com_categories&view=categories&extension=com_YOUR_COMPONENTThis confirms that category integration is active even if the dashboard shortcut is missing.
Summary
That's all there is to Categories integration in JCB - clean, native, and Joomla-standard.