This page is tagged because it NEEDS REVIEW. You can help the Joomla! Documentation Wiki by contributing to it.
More pages that need help similar to this one are here. NOTE-If you feel the need is satistified, please remove this notice.
How to Access
Navigate to the Category Manager. To add a new Category, press the 'New' icon in the toolbar. To edit an existing Category, click on the Category title or click the Category's checkbox and then click on the Edit icon in the toolbar.
This is where you can add a new Category to a Section or edit an existing Category. Categories are used to organize the Articles within a Section. Sections and Categories allow you to display related Articles together on a page and to filter Articles in the Article Manager. All Articles are assigned either to a Category that you create or to the special Category called 'Uncategorized'.
- Title. The Title for this item. This may or may not display on the page, depending on the parameter values you choose.
- Alias. The internal name of the item. Normally, you can leave this blank and Joomla! will fill in a default value. The default value is the Title or Name in lower case and with dashes instead of spaces. You may enter the Alias manually. The Alias should consist of lowercase letters and hyphens (-). No blank spaces or underscores are allowed. The Alias will be used in the URL when SEF is activated. Note: If the title consists of non-Latin characters, the Alias will default to the current date and time, for example "2009-02-11-17-54-38".
- Parent. Allows a parent category for the category being edited/created to be chosen.
- Published. Whether or not this item is published. Select Yes or No from the radio button group to set the Published state for this item.
- Access Level. Who has access to this item. Current options are:
- Public: Everyone has access
- Registered: Only registered users have access
- Special: Only users with author status or higher have access
- Enter the desired level using the drop-down list box.
- The permissions section for the category will be at the bottom of the screen and will look like the following:
- The options allowed are:
- Create new items in the category
- Delete existing items in the category
- Edit existing items in the category
- Edit State
- Change an items state (Publish, Unpublish, Archive, and Trash) in the category.
- Edit Own
- Edit existing items in the category that the logged in user has created.
- There are two very important points to understand from this screen. The first is to see how the permissions can be inherited from the parent Group. The second is to see how you can control the default permissions by Group and by Action.
- This provides a lot of flexibility. For example, if you wanted Shop Suppliers to be able to have the ability to create an item in the category, you could just change their Create value to "Allowed". If you wanted to not allow members of Administrator group to delete objects or change their state, you would change their permissions in these columns to Inherited (or Denied).
- It is also important to understand that the ability to have child groups is completely optional. It allows you to save some time when setting up new groups. However, if you like, you can set up all groups to have Public as the parent and not inherit any permissions from a parent group.
- Please note the inherited values will come from the Permissions set in the Global Configuration Permissions Tab
- Description. The description for the item. Section and Category descriptions for Articles may be shown on web pages, depending on the parameter settings. These descriptions are entered using the same editor that is used for Articles. Note that Section and Category descriptions may not be edited from the front end.
- Language. Select the language for this item. If you are not using the multi-language feature of Joomla, keep the default of 'All'.
- ID. The unique ID number automatically assigned to this item by Joomla!. This number cannot be changed.
The default editor for both front-end and back-end users in Joomla! is the TinyMCE editor.
TinyMCE is a WYSIWYG (what you see is what you get) editor that allows users a familiar word-processing interface to use when editing Articles and other content. The 3-row toolbar below provides many standard editing commands:
- Top Row.
- Buttons in the upper left allow you to make text bold, italic, underlined, or strikethrough. Next to that are buttons for align left, right, center, and full.
- Styles. Caption and System Pagebreak styles can be set. Highlight the desired text and select the style. This will allow this text to be formatted based on CSS rules.
- Format. Select pre-defined formats for Paragraph, Address, Heading1, and so on.
- Font Family. Select the desired font.
- Second Row.
- Unordered List, Ordered list, Outdent (move left) and Indent (indent right).
- Undo (Ctrl+Z) and Re-do (Ctrl+Y).
- Insert/Edit Link. To insert or edit a link, select the linked text and press this button. A popup dialog displays that lets you enter details about the link.
- Unlink. To remove a link, highlight the linked text and press this button.
- Insert/Edit Anchor. An anchor is a bookmark inside an article that lets you link directly to that point in the article. To insert an anchor, move the cursor to the desired location within the article and click this button. A window will display. Enter the name of the Anchor and press Insert. A small anchor icon will show in the location of the anchor. You can edit the name of the anchor by clicking on it and pressing this button. You can delete the anchor just by selecting it and pressing the Delete key.
- Insert/Edit Image. To insert and image, place the cursor in the desired location and press this button. A popup dialog displays that lets you enter in the Image URL and other information about how the image will display.
- Cleanup Messy Code. This button allows you to clean up HTML code, perhaps from HTML text that you copied in from another source.
- Edit HTML Source. A popup displays showing the HTML source code, allowing you to edit the HTML source code.
- Find and Find/Replace.
- Insert Date, Time, or Emotions.
- Insert Embedded Media. To insert embedded media (such as Flash), place the cursor at the desired location and press this button. A popup dialog will display that allows you to enter the Type, File or URL, and other information about the media.
- Direction Left to Right and Direction Right to Left. These buttons allow you to enter or change the text direction, for example for languages that read right to left.
- Insert New Layer, Move Forward, Move Backware, Toggle Absolute Position. For working with layered items.
- Select Text Color.
- Third Row.
- Insert Horizontal Ruler.
- Remove Formatting.
- Toggle Guidelines/Invisible elements.
- Subscript, Superscript, Insert Custom Character, Horizontal Rule.
- Insert New Table, Table Row Properties, Table Cell Properties, Insert Row Before, Insert Row After, Delete Row, Insert Column Before, Insert Column After, Delete Column, Split Merged Table Cells, Merge Table Cells.
- Toggle Full Screen Mode.
- Edit CSS Style. A popup dialog box displays that allows you to enter CSS style information for the selected text.
If 'No editor' is selected for a User, then a simple text editor displays. This allows you to enter in raw, unformatted HTML. You can use the toolbar 'Preview' button to preview how the HTML will display.
Note that the 'No Editor' option can be useful if you are entering in 'boilerplate' or custom HTML, for example to create a PayPal link. TinyMCE automatically re-formats and strips some HTML when a file is saved. This can cause complex HTML to not work correctly.
If this happens, you can temporarily change the editor to 'No Editor' and create the desired content. Note that if you wish to edit this content in the future, you should be careful to change your editor to 'No Editor'. Otherwise, if you open and save the content with TinyMCE, you may lose your custom HTML.
An Image button is located just below the edit window, as shown below:
At the top right you will see the toolbar:
The functions are:
- Save. Saves the content category and stays in the current screen.
- Save & Close. Saves the content category and closes the current screen.
- Save & New. Saves the content category and keeps the editing screen open and ready to create another content category.
- Cancel/Close. Closes the current screen and returns to the previous screen without saving any modifications you may have made.
- Help. Opens this help screen.