Actions

Help33

Difference between revisions of "Components Contacts Categories Edit"

From Joomla! Documentation

m (Related Information: updating Help screens relevant versions)
m (Related Information: clean up)
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<noinclude>{{Help screen navbox|3.0|Components Help Screens}}</noinclude>==Overview==
+
<noinclude>{{Help screen navbox|3.0|Components Help Screens}}</noinclude>
This screen is accessed from the back-end Joomla! administrator panel. It is used to create or edit Contact Categories in your Joomla! website.
+
 
+
 
==How to Access==
 
==How to Access==
Navigate to the [[Help30:Components_Contact_Categories|Contact Category Manager]]. To add a new Contact Category, press the "New" icon in the toolbar. To edit an existing Contact Category, click on the Category's Name or click the Category's checkbox and then click on the "Edit" icon in the toolbar.
+
Navigate to the [[Help31:Components_Contacts_Categories|Contact Category Manager]]. To add a new Contact Category, press the "New" icon in the toolbar. To edit an existing Contact Category, click on the Category's Name or click the Category's checkbox and then click on the "Edit" icon in the toolbar.
  
 
==Description==
 
==Description==
Line 9: Line 7:
  
 
==Screenshot==
 
==Screenshot==
[[Image:Help30-Components-Contact-Categories-Edit-screen.png]]
+
[[Image:Help30-Components-Contact-Categories-Edit-screen.png|670px]]
  
 
==Details and Options==
 
==Details and Options==
 
In this section, you can enter information about the Contact Category, such as name, alias, description, and so on.
 
In this section, you can enter information about the Contact Category, such as name, alias, description, and so on.
  
===Details===
+
==Details==
{{Chunk30:colheader|Title}}
+
{{Chunk30:Add Category Details}}
{{Chunk30:colheader|Alias}}
+
{{Chunk30:Add Category Publishing Options}}
{{Chunk30:colheader|Parent}}
+
{{Chunk30:Add Category Permissions}}
{{Chunk30:colheader|State}}
+
{{Chunk30:Add Category Options}}
{{Chunk30:colheader|Access}}
+
{{Chunk30:colheader|Permissions_SetPermissions}}
+
{{Chunk30:colheader|Language}}
+
{{Chunk30:colheader|Id}}
+
{{Chunk30:colheader|CategoryDescription}}
+
 
+
===Publishing Options===
+
{{Chunk30:PublishingOptions|CreatedBy}}
+
 
+
===Basic Options===
+
{{Chunk30:colheader|AlternativeLayout}}
+
{{Chunk30:colheader|Image}}
+
{{Chunk30:colheader|Note}}
+
 
+
===Metadata Options===
+
{{Chunk30:metadata|Description}}
+
{{Chunk30:metadata|Keywords}}
+
{{Chunk30:metadata|Author}}
+
{{Chunk30:metadata|Robots}}
+
 
+
===Category Permissions===
+
This section is where you can view and edit permissions for items that are part of this Contact Category.
+
 
+
[[Image:Help30-Components-Contact-Categories-Edit-permissions-subscreen.png]]
+
 
+
The tree on the left represents the user groups that have been defined for your Joomla! site, while the right part displays permissions for the currently selected group, and lets you edit those permissions:
+
 
+
{{Chunk30:Help_screen_component_options_permissions_columns_action}}
+
{{Chunk30:Help_screen_component_options_permissions_columns_select_new_setting}}
+
{{Chunk30:Help_screen_component_options_permissions_columns_calculated_setting}}
+
  
 
==Toolbar==
 
==Toolbar==
At the top left you will see the toolbar:
+
{{Chunk30:EditAndNewToolbars|Category Manager: Edit A Contact Category| Category Manager: Add A New Contact Category}}
  
[[Image:Help30-Save-SaveClose-SaveNew-Cancel-Help-toolbar.png]]
+
==TinyMCE editor==
 +
{{Chunk30:TinyMCE}}
  
The functions are:
+
==No editor==
{{Chunk30:Help_screen_toolbar_icon_Save|contact category}}
+
{{Chunk30:No editor}}
{{Chunk30:Help_screen_toolbar_icon_SaveAndClose|contact category}}
+
{{Chunk30:Help_screen_toolbar_icon_SaveAndNew|contact category}}
+
{{Chunk30:Help_screen_toolbar_icon_Cancel}}
+
{{Chunk30:Help_screen_toolbar_icon_Help}}
+
  
 
==Related Information==
 
==Related Information==
Line 66: Line 31:
 
*To find and edit existing Contacts: [[Help30:Components_Contacts_Contacts|Contact Manager]]
 
*To find and edit existing Contacts: [[Help30:Components_Contacts_Contacts|Contact Manager]]
  
<noinclude>{{cathelp|3.0,3.1|Components Help Screens}}</noinclude>
+
<noinclude>{{cathelp|3.0,3.1,3.2,3.3|Components Help Screens}}</noinclude>

Latest revision as of 10:57, 30 April 2014

Contents

How to Access

Navigate to the Contact Category Manager. To add a new Contact Category, press the "New" icon in the toolbar. To edit an existing Contact Category, click on the Category's Name or click the Category's checkbox and then click on the "Edit" icon in the toolbar.

Description

This is where you can add a Contact Category or edit an existing Contact Category. Contact Categories allow you to organize contacts in your web site. Contact Categories are separate from other types of Categories, such as those for Articles, Banners, News Feeds, and so on.

Screenshot

Help30-Components-Contact-Categories-Edit-screen.png

Details and Options

In this section, you can enter information about the Contact Category, such as name, alias, description, and so on.

Details

Category Details

  • 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".
  • Description. The description for the item. Category, Subcategory and Web Link descriptions may be shown on web pages, depending on the parameter settings. These descriptions are entered using the same editor that is used for Articles.
Help30-Article-Image-ToggleEditor-buttons.png
  • Article. Click to quickly add an 'Article' link to the description with a popup window.
  • Image. Click to quickly add an 'Image' to the description with a popup window.
  • Toggle Editor. Turns on or off the the editor's description box WYSIWYG features to show HTML markup.

Details (sidebar)

  • Parent. The item (category, menu item, and so on) that is the parent of the item being edited.
  • Tags. Enter one or more optional tags for this item. You can select existing tags by entering in the first few letters. You may also create new tags by entering them here. Tags allow you to see lists of related items across content types (for example, articles, contacts, and categories).
  • Status. (Published/Unpublished/Trashed) The published status of the item.
  • Access Level. Who has access to this item. Default options are:
    • Guest: Everyone has access
    • 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. Custom Access Control Levels created will show if they exist.
  • Language. Item language.
  • Note. Item note. This is normally for the site administrator's use (for example, to document information about this item) and does not show in the front end of the site.
  • Version Note. Optional field to identify this version of the item in the item's Version History window.

Publishing Options

This section shows Publishing Options parameters for this Category, as shown below when tab is clicked:

Help30-Categories-Edit-screen-publish-options-tab.png

The grayed out fields are for information only and may not be edited.

  • Created Date. Date the item(Article, Category, Weblink, etc.) was created.
  • Created by. Optional, choose from a popup window of users. Select User by clicking on the user's name. Defaults to user creating new category if left blank.
  • Modified Date. (Informative only) Date of last modification.
  • Modified By. (Informative only) Username who performed the last modification.
  • Hits. Number of hits on a Category views.
  • ID. The unique ID number automatically assigned to this item by Joomla!. This number cannot be changed.
  • Meta Description. An optional paragraph to be used as the description of the page in the HTML output. This will generally display in the results of search engines. If entered, this creates an HTML meta element with a name attribute of "description" and a content attribute equal to the entered text.
  • Meta Keywords. Optional entry for keywords. Must be entered separated by commas (for example, "cats, dogs, pets") and may be entered in upper or lower case. (For example, "CATS" will match "cats" or "Cats"). Keywords can be used in several ways:
  1. To help Search Engines and other systems classify the content of the Article.
  2. In combination with Banner tags, to display specific Banners based on the Article content. For example, say you have one Banner with an ad for dog products and another Banner for cat products. You can have your dog Banner display when a User is viewing a dog-related Article and your cat Banner display for a cat-related Article. To do this, you would:
    1. Add the keywords 'dog' and 'cat' to the appropriate Articles.
    2. Add the Tags 'dog' and 'cat' to the appropriate Banners in the Banner Manager New/Edit screen.
    3. Set the Banner module Parameter 'Search By Tags' to 'Yes in the Banner Module Edit screen.
  3. For articles only, in combination with the Related Articles module, to display Articles that share at least one keyword in common. For example, if the current Article displayed has the keywords "cats, dogs, monkeys", any other Articles with at least one of these keywords will show in the Related Articles module.
  • Author. Optional entry for an Author name within the metadata. If entered, this creates an HTML meta element with the name attribute of "author" and the content attribute as entered here.
  • Robots. The instructions for web "robots" that browse to this page.
    • Use Global: Use the value set in the Component→Options for this component.
    • Index, Follow: Index this page and follow the links on this page.
    • No index, Follow: Do not index this page, but still follow the links on the page. For example, you might do this for a site map page where you want the links to be indexed but you don't want this page to show in search engines.
    • Index, No follow: Index this page, but do not follow any links on the page. For example, you might want to do this for an events calendar, where you want the page to show in search engines but you do not want to index each event.
    • No index, no follow: Do not index this page or follow any links on the page.

Permissions

This section shows permissions for this category. The screen shows as follows.

Help30-Categories-Edit-screen-permissions-tab.png

To change the permissions for this category, do the following.

  1. Select the Group by clicking its title located on right.
  2. Find the desired Action. Possible Actions are:
    Create. Users can create this category.
    Delete. Users can delete this category.
    Edit. Users can edit this category.
    Edit State. User can change the published state and related information for this category.
    Edit Own. Users can edit own category created.
  3. Select the desired permission for the action you wish to change. Possible settings are:
    Inherited. Inherited for users in this Group from the Global Configuration, Article Manager Options, or Category permissions.
    Allowed. Allowed for users in this Group. Note that, if this action is Denied at one of the higher levels, the Allowed permission here will not take effect. A Denied setting cannot be overridden.
    Denied. Denied for users in this Group.
  4. Click Save in Toolbar at top. When the screen refreshes, the Calculated Setting column will show the effective permission for this Group and Action.

Options

This shows Options for this Category, as shown below when tab is clicked:

Help30-Categories-Edit-screen-options-tab.png

  • Alternative Layout. Use a different layout from the supplied components view or overrides in the templates.
  • {{{Image}}}. Choose an image to be displayed with this item/category in the front-end.

Toolbar

At the top left you will see the toolbar for a Edit Item or New Item

Category Manager: Edit A Contact Category:

Help32-Save-SaveClose-SaveNew-SaveAsCopy-Version-Close-toolbar.png

  • Save. Saves the menu item and stays in the current screen.
  • Save & Close. Saves the menu item and closes the current screen.
  • Save & New. Saves the menu item and keeps the editing screen open and ready to create another menu item.
  • Save as Copy. Saves your changes to a copy of the current menu item. Does not affect the current menu item. This toolbar icon is not shown if you are creating a new menu item.
  • Versions. Opens the Item Version History window to show any prior versions of this item. This allows you to view older versions of this item and, if desired, restore from an older version. See Version History for more information.
  • Cancel/Close. Closes the current screen and returns to the previous screen without saving any modifications you may have made.

Help32-Help-toolbar.png

  • Help. Opens this help screen.

Category Manager: Add A New Contact Category:

Help32-Save-SaveClose-SaveNew-Cancel-toolbar.png

  • Save. Saves the menu item and stays in the current screen.
  • Save & Close. Saves the menu item and closes the current screen.
  • Save & New. Saves the menu item and keeps the editing screen open and ready to create another menu item.
  • Cancel/Close. Closes the current screen and returns to the previous screen without saving any modifications you may have made.

Help32-Help-toolbar.png

  • Help. Opens this help screen.

TinyMCE editor

TinyMCE is the default editor for both front-end and back-end users. 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. TinyMCE can be configured with three different sets of toolbar buttons: advanced, simple, and extended. This is set as an option in the Plugin Manager for the 'Editor - TinyMCE' plugin.

Advanced Toolbar


The advanced toolbar provides a three-row toolbar as shown below:

Help30-editor-tinymce-advanced.png

This is the default setting. The 3-row toolbar below provides many standard editing commands, as follows:

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.

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.
  • About TinyMCE editor. Shows the TinyMCE version.
  • Edit HTML Source. A popup displays showing the HTML source code, allowing you to edit the HTML source code.

Third Row.

  • Insert Horizontal Ruler.
  • Remove Formatting.
  • Toggle Guidelines/Invisible elements.
  • Subscript, Superscript, Insert Custom Character

Simple Toolbar


The simple toolbar provides one row of buttons as shown below. They are located on the bottom of the edit window.

Help30-editor-tinymce-simple.png

First Row.

  • Buttons allow you to make text bold, italic, underlined, or strikethrough.
  • Undo (Ctrl+Z) and Re-do (Ctrl+Y).
  • Cleanup Messy Code. This button allows you to clean up HTML code, perhaps from HTML text that you copied in from another source.
  • Unordered list, Ordered list.

Extended Toolbar


The extended toolbar provides the most extensive editing options, as shown below.

Help30-editor-tinymce-extended.png

This option provides all of the same buttons as documented in the Advanced Toolbar above. In addition, the following options are available:

First Row.

  • Font Family. Select the desired font.
  • Font Size. Select the desired font size.

Second Row.

  • Find and Find/Replace.
  • Insert Date or Time.
  • Select Text Color or Background Color.
  • Toggle Full Screen Mode.

Third Row.

  • 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.
  • Insert 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.
  • Insert horizontal line.
  • 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.

Fourth Row.

  • Cut, Copy, Paste, Paste as Plain Text, Paste from Word. Often when copying and pasting text from other sources, such as PDF files, Word documents, or web pages, the selected text contains formatting information that is not needed or wanted. Using the Paste as Plain Text will strip out all formatting from the text. Paste as Word tries to preserve some of the formatting while stripping out unnecessary formatting.
  • Select All.
  • Insert New Layer, Move Forward, Move Backware, Toggle Absolute Position. For working with layered items.
  • Edit CSS Style. A popup dialog box displays that allows you to enter CSS style information for the selected text.
  • Citation, Abbreviation, Acronym, Insertion, Deletion, Insert/Edit Attributes.
  • Show/Hide Visual Control Characters (like paragraph endings).
  • Show/Hide Block Elements.
  • Insert Non-Breaking Space Character.
  • Block Quote.
  • Insert Predefined Template Content.

No editor

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.

Related Information