From Joomla! Documentation
Revision as of 10:36, 13 October 2017 by FuzzyBot (Updating to match new version of source page)
Joomla! can use a variety of WYSIWYG editors for content creation, which gives you flexibility in how you put together content. The default editors are covered below; however, other editors are available, most without cost, and can offer a great range of functionality.
If, for instance, you plan to create content in word processing software like Microsoft Office Word or OpenOffice Writer, you may want to look at an editor like JCK, which offers the ability to "Paste from Word" so it automatically cleans up some of the unnecessary formatting generated by those programs.
Other editors may offer better management of multimedia content, like video, audio, and Flash. It is important to choose the best editor for your needs. Keep in mind, you can also load more than one editor into Joomla! and assign the most appropriate editor to each user individually, overriding the default editor as needed.
Content layout is partially controlled by the Joomla! template that is in use for your site. This controls where you can place content on the page through defined module positions. For instance, many templates include a left module that places content in a column running down the left side of the page. Module positions are individual to each template and can be highly varied.
Within any given position, including the main content area, you can layout content through html and/or css controls as you would on any web page. You may use tables, divs, paragraphs, etc, to create whatever layout you need. Generally, you do this through the WYSIWYG editor in Joomla, although it can also be done through stylesheets that are made part of the template.
Content workflow is the process of how your content will be published. When creating or editing content, you have the option to control the steps it takes to finish it. This will often involve constant editing of content until satisfaction is reached. A system that allows you to version your files and keep important information such as creation dates, are just some examples of having efficient work flow.
The Joomla! content manager shows you the revision numbers and by whom the while was created or edited. When you are finally ready to make your content public, you can publish it immediately or at a certain date and time. You will always be able to edit your content at anytime and you can also choose to hide your content if you feel it is not ready to be used.
Metadata is a set of data that gives information about other data. It can also be described as attributes of the data. For example, the author, the date created, the language the content is written in, and the file size, are all examples of metadata. The content metadata can be automated, or manually inserted based on the content creator. When creating content using Joomla!, you are allowed to give your own metadata.
This is inserted via the "Meta Description" and "Meta Keywords" boxes in the "Publishing" tab, when creating or editing content.
With a typical Joomla! installation, three optional (Published/Unpublished) editors are included. These editors are the TinyMCE wysiwyg (what you see is what you get), CodeMirror and a generic text editor.
These editors can be set as the site default in Global Configuration, or per user in either the User Manager by an administrator or by the user themselves in their user profile ("Your Details") in the Front-end. Each of these editors have distinct functionality, parameters, as well as controls. For additional information not covered here, please see any references cited in the respective section.
The TinyMCE editor is the default wysiwyg editor plugin that ships with Joomla. This editor is used to create content or articles in which the content or article can be viewed as it will appear once completed, while being written. The TinyMCE editor is the default editor set within the Global Configuration parameters. However, a user can set this parameter in their respective profile using the Your Details User Menu menu item, or by an administrator via the User Manager in the Back-end.
TinyMCE functionality and parameters
The functions available for use with the TinyMCE editor is rather extensive and cannot be covered entirely here, in particular with regards of usage. However, some of the basic functions and parameters will be briefly covered. See the reference link below for more information regarding additional functions and controls.
First and foremost, the TinyMCE editor has three Functionality configurations which control the behavior of the editor. These configurations are Simple, Advanced and Extended.
- Simple:The "Simple" configuration is relatively similar to a simple text editor with the exception of a few basic controls. These controls pertain to text formatting, operations, and lists. Specifically, text can be formatted as bold, italic, underlined and be given a strikethrough. With regards to inserting lists, both ordered and unordered lists can be created.
- Advanced: The functions available under the "Advanced" functionality configuration allow far more control over content creation. For example, inserting images, formatting text, creating anchors, tables and more. Additionally, template defined CSS classes can be used, as well as end-user defined or Custom CSS classes. This setting can be found in the parameters section of the plugin editor, via the Plugin Manager.
To achieve this functionality, simply create the CSS classes file, select the 'No' radio button for "Template CSS classes", and enter the path to your file in the "Custom CSS classes" text entry field, similar to templates/current_template/css/custom_css.css. In addition to end-user defined CSS classes, lower level and advanced level parameters regarding editor behavior, can be chosen. These include, RTL (right to left) formatting, Relative and Absolute Urls, Language, Date and Time format, and more.
- Extended: The functions available under the "Extended" functionality configuration allow the highest control over content creation. For example, it adds features such as Find and Replace, Text Color and Highlighting, the possibility to add Emoticons, Embedded Media, to change the text direction to RTL (right to left), tables layers and CSS styling from within the TinyMCE Editor.
CodeMirror is not a WYSIWYG editor. The option is found in the Global Configuration and User Manager Add/Edit screens from the backend, or chosen by the user in their respective profile launches a simple text editor for creating and submitting content. Using this option, requires that users have a basic understanding of the HyperText Markup Language (HTML) to create and submit content. See references below for more information regarding the use of HTML tags used during the creation of content or articles.
Joomla! specific editor functions
The Pagebreak function adds the ability to insert a Table of Contents for articles spanning multiple pages. Placing the cursor at the chosen location of the Pagebreak and clicking the "Pagebreak" icon in the lower editor panel launches a configuration screen in which the Page Title and TOC alias may be entered. This function is available for use in both the wysiwyg and text type editors. For those who choose using HTML over the wysiwyg to insert the Pagebreak, the available code(s) are listed in the Content - Pagebreak plugin editor screen, accessed via the Plugin Manager.
To use the Read more... function:
- Position the edit cursor at the place in the text where you want the read-more message to appear.
- Click the Read more button below the text box. The read-more message tag is inserted.
- The read-more message tag can be selected, and moved or deleted.
Creating and submitting an article from the back-end
Most content or articles can be created from the Front-end by any user belonging to the 'Author' group. This group is allowed to create and edit their own content; in some instances, a user may be given priviledges to access the Administrative Backend. Whether as a Manager, Administrator, or Super Administrator.
For all intents and purposes, the following will be written from a Manager(s) perspective. Most likely the access to the back-end could be reserved for those belonging to the editors or publishers group and not normal authors, however in the interest of content creation, those operations reserved for Managers will be briefly covered. More information regarding specific tasks within those mentioned below can be found in their respective Help Screens.
The article manager can be reached by selecting Content → Article Manager from the Administrator's Toolbar in the backend administrator (http://www.yoursite.com/administrator).
From the article manager you can see all of the articles that have been created on your site. Between the Article Manager toolbar and the list of articles you will see the filter bar. The filter bar will help you quickly find articles on your site by either searching for a string of text in the title of an article or by drilling down into content using the dropdown selectors.
Using the Filter search box
If you know the name of the article you are trying to find, or if you know part of the name of the article, you can use the Filter search box to locate the article. Type some characters from the article title into the filter search box and hit go. The text box is NOT case sensitive. After hitting go you will see a list of all articles on your site containing the search string.
Using the Selectors
There are currently 7 content selectors that can be used in conjunction with any or all of the other selectors: Status, Category, Access, Language, Tag, Author and Max Levels.
- Status - This will allow you to see only Published, Unpublished, Archived or Trashed articles.
- Category - Select from the Categories on your site to see all articles in that category.
- Access - Select an Access level to see only the articles with the selected viewing access level.
- Language - For multilingual websites, select a language to see only the articles in the selected language.
- Tag - Select a Tag to see only the articles containing the slected tag.
- Author - Select an Author to see only the articles from that Author. This can be combined with the previous selectors so that you can see, for example, only articles from the selected Author in a particular Category.
- Max Levels - Select a Level (from 1 to 10) to see only articles that have a specified viewing access level.
- Level 1: Only show items whose category is at the top level in the category hierarchy (in other words, with categories whose parent category is "- No Parent -".)
- Levels 2-10: Only show items whose category is in the top 2-10 levels in the category hierarchy.
Article Manager Toolbar
The article manager toolbar is located above the filter bar and below the Administrator toolbar. It contains the following options:
- New. Opens the editing screen to create a new article.
- Edit. Opens the editing screen for the selected article. If more than one article is selected (where applicable), only the first article will be opened. The editing screen can also be opened by clicking on the Name of the article.
- Publish. Makes the selected articles available to visitors to your website.
- Unpublish. Makes the selected articles unavailable to visitors to your website.
- Feature. Marks selected articles as featured. Works with one or multiple articles selected.
- Archive. Changes the status of the selected articles to indicate that they are archived. Archived articles can be moved back to the published or unpublished state by selecting "Archived" in the Select Status filter and changing the status of the articles to Published or Unpublished as preferred.
- Check-in. Checks-in the selected articles. Works with one or multiple articles selected.
- Batch. Batch processes the selected articles. Works with one or multiple items selected.
- Trash. Changes the status of the selected articles to indicate that they are trashed. Trashed articles can still be recovered by selecting 'Trashed' in the 'Select Status' filter and changing the status of the articles to Published or Unpublished as preferred. To permanently delete trashed articles, select 'Trashed' in the 'Select Status' filter, select the articles to be permanently deleted, then click the 'Empty Trash' toolbar icon.
- Help. Opens this help screen.
- Options. Opens the Options window where settings such as default parameters can be edited. See Article Manager Options for more information.