Help310

Help310:Content Article Manager Edit

From Joomla! Documentation

Revision as of 07:44, 29 March 2022 by FuzzyBot (talk | contribs) (Updating to match new version of source page)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Other languages:
Deutsch • ‎English • ‎Nederlands • ‎Türkçe • ‎français • ‎português


Description

This is where you can

  • Add a new Article.
  • Edit an existing Article.

You can also select the Category for an Article and indicate whether or not it is Published and if it is selected to appear on the Frontpage.


How to Access

Add a new Article

  • Click the New button in the toolbar.

Edit an existing Article

  • Click on an Article's Title.
  • Check the Article's Checkbox
  • Click the Edit button in the toolbar.


Screenshot

Help-3x-content-article-manager-add-new-article-en.png


Form Fields

  • Title. The Title for the article.
  • Alias. The internal name of the article. Normally, you can leave this blank and Joomla will fill in a default value. The default value is the Title in lower case and with dashes instead of spaces. You may enter the Alias manually. Learn more about Aliases.

Content

  • Article Text. This is where you enter the contents of the article. The editor you use depends on the settings for your site and your user. Joomla core includes 3 editor options: TinyMCE (the default), Code Mirror, and No Editor. Learn more about Joomla core editors.

Help30-Administrator-Articles-Edit-Editor-Sidebar-Params-en.png
  • Status. (Published/Unpublished/Archived/Trashed) The published status of the article.
  • Category. The Category this article belongs to. You may create new categories by entering them here.
  • Featured. (Yes/No) Select Yes if the article will be shown in the Featured menu item.
  • Access. Who has access to this article.
    • Public: Everyone has access.
    • Guest: Everyone has access.
    • Registered: Only registered users have access.
    • Special: Only users with author status or higher have access.
    • Super Users: Only super users have access.
  • Language. Select the language for this article. If you are not using the multi-language feature of Joomla, keep the default of All.
  • Tags. Enter one or more optional tags for this article. 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).
  • Note. Article note. This is normally for the site administrator's use (for example, to document information about this article) and does not show in the Frontend of the site.
  • Version Note. Optional field to identify this version of the article in the article's Version History window.

Images and Links

Note: This tab can be hidden by users with Admin Permission for articles. This section lets you display images and links in your articles using standardized layouts.

Help30-screenshot-article-edit-images-links-en.png
  • Intro Image. Click the Select button to select an image to be displayed in a fixed location in the Intro Text of an article. This will open a window that allows you to select an image from your images folder. After you have selected an image, you can hover the mouse on the "Preview" text to see a preview of the image.
  • Image Float. (Use Global/Right/Left/None) Controls placement of the image.
  • Alt Text. Alternative text to use for visitors who don't have access to images.
  • Caption. Enter an optional caption for the image.

  • Full Article Image. Click the Select button to select an image to be displayed in a fixed location in the Full Text of an article. This will open a window that allows you to select an image from your images folder. After you have selected an image, you can hover the mouse on the "Preview" text to see a preview of the image.
  • Image Float. (Use Global/Right/Left/None) Controls placement of the image.
  • Alt Text. Alternative text to use for visitors who don't have access to images.
  • Caption. Enter an optional caption for the image.

  • Link A. The URL for the first link to be displayed in a fixed location in the article text. This must be a full URL, not relative. For example, it normally would start with https://.
  • Link A Text. The text used for Link A. If blank, the URL will be displayed.
  • URL Target Window. Sets the default value for the target for the first Link in the article. Choices are:
    • Use Global: Use the value set in Articles  Options.
    • Open in parent window: Opens the link in the main browser window, replacing the current Joomla article.
    • Open in new window: Opens the link in a new browser window.
    • Open in pop up: Opens the link in a pop-up browser window (without full navigation controls).
    • Modal: Opens the link in a modal pop-up window.
    Note: Same options for 'Link B' and 'Link C'.

Options

Note: This tab can be hidden by users with Admin Permission for articles. This is a set of options you can use to control how this article will show in the Featured or Category blog layout. Joomla allows you to set these options at the following levels:

  1. In Article Options
  2. When you set up a Category Blog or Featured Articles menu item.
  3. When you create the article here.

When you create the blog menu item, you can set each of these options as follows:

  • Use Global: Uses the setting from Article Options
  • Yes/No or Show/Hide: Use the setting in that menu item.
  • Use Article Settings: Use the setting set here for the specific article. This allows you to show different articles with different options in the same blog page. For example, one article might show the author and a different article might not show the author.

The following Article Options can be set:

Help30-screenshot-article-edit-article-options-en.png
  • Layout. (Use Global/Default) Use a different layout from the supplied component view or overrides in the templates.
  • Show Title. (Use Global/Show/Hide) Whether or not to show the article's Title.
  • Linked Titles. (Use Global/Yes/No) If the article's Title is shown, whether to show it as a link to the article.
  • Show Tags. (Use Global/Show/Hide) Show or hide the tags for the article.
  • Show Intro Text. (Use Global/Show/Hide) If set to Show, the Intro Text of the article will show when you drill down to the article. If set to Hide, only the part of the article after the "Read More" break will show.
  • Position of Article Info. (Use Global/Above/Below/Split). Puts the article information block above or below the text or splits it into two separate blocks. One block is above and the other is below.
  • Article Info Title. (Use Global/Show/Hide) Displays the 'Article Info' title on top of the article information block.
  • Show Category. (Use Global/Show/Hide) Whether or not to show the Article's Category.
  • Link Category. (Use Global/Yes/No) If the category title is shown, whether or not to show it as a link to a Single Category menu item for the category.
    Note: You can set this to be either a blog or list layout with the "Choose a layout" option in the Category Options.
  • Show Parent. (Use Global/Show/Hide) Whether or not to show the Article's Parent Category.
  • Link Parent. (Use Global/Yes/No) If the Article's Parent Category is shown, whether to show it as a link to a Category layout (list or blog) for that Category.
  • Show Associations. (Use Global/Show/Hide) Show or hide the associated article's flags or URL Language code.
    Note: Multilingual only.
  • Show Author. (Use Global/Show/Hide) Whether to show the author of the Article.
  • Link Author. (Use Global/Yes/No) If the author is shown, whether or not to show it as a link to the Joomla user.
    Note: This will only show as a link if there is a Contact associated with this user. Also, a link will not show if there is an Author Alias value for the article.
  • Show Create Date. (Use Global/Show/Hide) Whether or not to show the Article's create date.
  • Show Modify Date. (Use Global/Show/Hide) Whether or not to show the Article's modify date.
  • Show Publish Date. (Use Global/Show/Hide) Whether or not to show the Article's start publishing date.
  • Show Navigation. (Use Global/Show/Hide) Whether or not to show a navigation link (for example, Next or Previous article) between articles.
  • Show Icons. (Use Global/Show/Hide) If set to Show, Print and Email will use icons instead of text.
  • Show Print. (Use Global/Show/Hide) Show or hide the Print Article button.
  • Show Email. (Use Global/Show/Hide) Show or hide the Email Article button.
  • Show Voting. (Use Global/Show/Hide) Whether or not to show the a voting icon for the Article.
    Note: The Plugin Content - Vote has to be enabled.
  • Show Hits. (Use Global/Show/Hide) Show or hide the number of times the article has been viewed (called hits).
  • Show Unauthorised Links.
    • Yes: The Intro Text for restricted articles will show. Clicking on the "Read More" link will require users to log in to view the full article content.
    • No: Articles that the user is not authorised to view (based on the viewing access level for the article) will not show.
  • Positioning of the Links. (Use Global/Above/Below) If there are links associated with this article, whether to show them above or below the article.

  • Read More Text. Optional field that allows you to customize the text that shows for a "read more" link. The default wording for English is "Read more".
  • Browser Page Title. Optional text for the "Browser page title" element to be used when the article is viewed with a non-article menu item. If blank, the article's title is used instead.

Fields

Note: This tab can be hidden by users with Admin Permission for articles. This section shows the custom fields which are defined for this article. Learn more about adding custom fields.

Help30-Content-Article-Manager-Edit-Fields-options-subscreen-en.png

Publishing

Note: This tab can be hidden by users with Admin Permission for articles.

Help30-Content-Article-Manager-Edit-publishing-options-subscreen-en.png

These entries are optional. Joomla automatically creates default entries for these values.

  • Start Publishing. Date and time to start publishing. Use this field if you want to enter content ahead of time and then have it published automatically at a future time.
  • Finish Publishing. Date and time to finish publishing. Use this field if you want to have content automatically changed to Unpublished state at a future time (for example, when it is no longer applicable).
  • Created Date. This field defaults to the current time when the article was created. You can enter in a different date and time or click on the calendar icon to find the desired date.
  • Created By. Name of the user who created the article. This will default to the currently logged-in user. If you want to change this to a different user, click the 'Select User' button Help30-select-user-en.png.
  • Created by Alias. This optional field allows you to enter in an alias for the Author. This allows you to display a different Author name for this article.
  • Modified Date. (Informative only) Date of last modification.
  • Modified By. (Informative only) Username who performed the last modification.
  • Revision. (Informative only) Number of revisions to this article.
  • Hits. (Informative only) The number of times an article has been viewed.

  • 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").
    Learn more about Meta Keywords.
  • Key Reference. Used to store information referring to an external resource.
  • Robots. The instructions for web "robots" that browse to this page.
    • Use Global: Use the value from the Metadata Settings.
    • index, follow: Index this page and follow the links on this page.
    • noindex, 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, nofollow: 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.
    • noindex, nofollow: Do not index this page or follow any links on the page.
  • 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.
  • Content Rights. Describe what rights others have to use this content.
  • External Reference. An optional reference used to link to external data sources. If entered, this creates an HTML meta element with a name attribute of "xreference" and a content attribute equal to the entered text.

Configure Edit Screen

Note: This tab by default is only visible to those with Admin permissions for the Article Manager permissions.

Help30-screenshot-article-edit-configure-edit-screen-en.png

On some installations you may need to save the Content Options in order for these options to work.

  • Show Publishing Options. (Use Global/No/Yes) If No, the Publishing tab in this screen will not show. This means that backend users will not be able to edit the fields in this tab. These fields will always be set to their default values.
  • Show Article Options. (Use Global/No/Yes) If No, the Article tab in this screen will not show. This means that backend users will not be able to edit the fields in this tab. These fields will always be set to their default values.
  • Administrator Images and Links. (Use Global/No/Yes) If Yes, the Images and Links will show in this screen.
  • Frontend Images and Links. (Use Global/No/Yes) If Yes, the Images and Links fields will show in the Frontend article editor screen. These fields allow users to optionally enter 2 images and 3 links in an easy-to-use form in the Frontend. When used with a single-article override, this can allow the site administrator to create a simple form for users to create standard article layouts.

Permissions

Joomla lets you set permissions for articles at 4 levels, as follows.

  1. Globally, using System  Global Configuration.
  2. For all articles, using Content  Articles  Options.
  3. For all articles in a category, using Content  Categories  Options.
  4. For an individual article, using this screen.

Manage the permission settings for user groups.

Help30-screenshot-article-edit-permissions-en.png

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

1. Select the Group by clicking its title located on the left.
2. Find the desired Action. Possible Actions are:
  • Delete. Users can delete content of article.
  • Edit. Users can edit content of article.
  • Edit State. Users can change the published state and related information for content of article.
3. Select the desired Permission for the action you wish to change. Possible settings are:
  • Inherited: Inherited for users in this Group from the category permissions of this article.
  • 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.


Toolbar

At the top left you will see the toolbar.

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

The functions are:

  • Save. Saves the article and stays in the current screen.
  • Save & Close. Saves the article and closes the current screen.
  • Save & New. Saves the article and keeps the editing screen open and ready to create another article.
  • Save as Copy. Saves your changes to a copy of the current article. Does not affect the current article.
    Note: This toolbar icon is only shown if you edit an existing article.
  • Versions. Opens the Article Version History window to show any prior versions of this article. This allows you to view older versions of this article and, if desired, restore from an older version. Learn more about Version History.
  • Close. Closes the current screen and returns to the previous screen without saving any modifications you may have made.
  • Help. Opens this help screen.


Quick Tips

  • The hierarchy of display parameters is as follows:
    • Parameters - Advanced for the specific Article. A setting other than 'Use Global' here always controls the setting.
    • Parameters - Component for the Menu Item. If the Parameters - Advanced above is 'Use Global' and this setting is not 'Use Global', then this controls the setting.
    • Global Configuration settings in the Article Manager/Parameters section. Settings here only apply if both of the above are set to 'Use Global'.
    Example: The 'Title Linkable' setting in the Article's 'Parameters - Advanced' section is set to 'Use Global'. The Menu Item is an Article Layout, and 'Title Linkable' in the 'Parameters - Component' is 'No'. The Global Configuration 'Title Linkable' is set to 'Yes'. The result will be 'Yes', since the Menu Item overrides the Global Configuration.
  • You can add images using either the TinyMCE Insert/Edit Image icon or the Image button. For adding new images in an Article, it is easier to use the Image button. This is because it lets you browse to the image file and also lets you upload images. However, for editing an existing image, you need to use the TinyMCE icon. The Image button only supports adding new images.
  • 'Read more...' breaks allow you to save space on the Front Page or on any blog layout page by showing just the first portion of an Article. 'Pagebreaks' allow you to provide multi-page navigation for long Articles. You can use both on one Article, if desired. For example, you could put a 'Read more...' break after the first paragraph of a multi-page article, and have Pagebreaks after each page. No page navigation would display on the Front Page until the User selects the 'Read more...' link. At that time, the Article's table of contents would display showing links to every page.
  • You can insert a Joomla Module inside an Article by typing "{loadposition xxx}", where "xxx" is the position entered for the desired Module. Note that the position name must not conflict with a position used by your Joomla! template. It can be any name (e.g., "mymoduleposition1") as long as it matches the position name typed in for the Module. The Menu Assignment for the Module must include the Menu Item where the Article is displayed, and the Plugin called "Content - Load Module" must be enabled (which it is by default). This feature allows you, for example, to insert a Custom HTML Module anywhere in an Article.


Related Information

Related Help Screens Description
Components Article Manager Options Used to set global defaults for menu items that display articles. These default values will be used when "Use Global" is selected for an option in an Articles menu item. For example, to show the 'Create Date' for an article in your Articles menu items, then set that option to "Show" here and it will be the default value. You do not need to set any of these options. Your Joomla site will work with the default settings.
Content Article Manager The Article Manager is used to find, mark featured, add and edit articles. See Toolbar below for a detailed list of all functions.
Content Featured Articles Used to control which 'Featured Articles' are displayed on the Front Page and in what order they are displayed. The Front Page is often the Home page of a web site, but it can be any page in the site. The Front Page is created using a Menu Item with the 'Featured Articles' Menu Item Type.
Extensions Module Manager Articles Archive This module shows a list of the calendar months containing archived articles. After you have changed the status of an article to archived, this list will be automatically generated.
Extensions Module Manager Articles Categories This module displays a list of articles from one or more categories.
Extensions Module Manager Articles Category This module displays a list of published articles from one or more categories.
Extensions Module Manager Articles Newsflash The Article Newsflash Module will display a fixed number of Articles from a specific Category or a set of Categories.
Extensions Module Manager Articles Related This Module shows a list of Articles that are related to the current Article being viewed by the user (for example, a Article Layout or a Blog or List layout where the user has clicked on an Article link). Articles are considered to be related to each other if they share at least one Keyword in the Article's Metadata Information. Article Keywords are entered in the Metadata Information section of the Article Manager - New/Edit screen.
Menus Menu Item Article Archived Used to show a list of Archived Articles. The Archived Article list can be displayed by date, filtered, and intro text added as shown below.
Menus Menu Item Article Categories Used to show a list of Categories. Categories are shown in a hierarchical list, as shown below. Depending on the selected options for this layout, you can click on a category Title to show the articles in that category.
Menus Menu Item Article Category Blog Used to show articles belonging to a specific Category in a blog layout. Controls the Introduction or Leading Article, additional Articles with intro text, and additional links to more Articles in the same category. Some examples of settings for the Blog Layout format include: number of articles, article columns, across or down layouts, and number of additional links. See the Advanced Details Tab for all this menu item.
Menus Menu Item Article Category List Used to show articles belonging to a specific Category in a list layout.
Menus Menu Item Article Create Allows users to submit an article. Normally this is available only to users who have logged in to the front end of the site. Users must have permission to create articles. When the Create Article page is shown in the front end, the screen shows as examples in the following Front End Screenshots section.
Menus Menu Item Article Featured Used to show all Articles that have been tagged as Featured. Articles are shown in a Blog Layout.
Menus Menu Item Article Single Article Used to show one article in the front end of the site.