Static Content Item: New / Edit

1012_doc_icon

Title:

com_content

Access:

menu=>Content=>Static Content Manager=>New/Edit

or

Quick Icon=>Static Content Manager=>New/Edit

User Level:

Manager; Administrator; Super Administrator.

Screenshot:

static_content_item_ss
Static Content Item: New/Edit

Description:

The Static Content Item New, and Edit, screens allow the creation of new Static Content Items in the Back-end for display on the Front-end of the Joomla! web site and the ability to edit existing Static Content Items that have been entered either through the Front-End or the Back-end of Joomla!

note icon NOTE: The New and Edit screens are almost identical in their appearance and functionality, accordingly only one example of the screen is displayed above.

Toolbar:

prev_upload_save_apply_cancel_help_tb prev_upload_save_apply_close_help_tb
Static Content Item: New Static Content Items: Edit

Preview: To check the appearance of the current Static Content Item in a browser-style window, click the Preview icon. A pop-up display page will appear. Close the pop-up by clicking anywhere upon it.

Upload: To upload a file from a local computer click the Upload icon. A small pop up dialogue window will appear. To trace the file to be Uploaded click on the Browse button. This will open the File Upload dialogue window. Navigate to the location of the desired file on the local hard drive. Select the file and click the Open button. The dialogue window will disappear and the path to, and name of, the file will appear in the File Upload field. Click the Uploadbutton to complete the transfer of a copy of the file from the local computer to the joomla_root/images/stories directory tree in the case of images. Other file types are copied to the joomla_root/media/ directory tree.

note711_small NOTE: There is usually an upper limit to the size of files that can be uploaded within the web server itself. This limit is set in the PHP configuration file (php.ini) and may differ between web servers and web hosts. The limit cannot be altered from within Joomla!. Some hosting companies do not allow the limit to be altered at all!

To allow larger files to be uploaded it will probably be necessary to increase the upload_max_filesize and the post_max_size settings.

For very large files it may also be necessary to increase the max_execution_time and the memory_limit settings. Alternatively it may be necessary to use an external program (FTP) to upload the files.

Save: Click Save to save any changes made during the current editing session, and return to the Static Content Manager screen.

Apply: Click Apply to save any changes made so far in the current session, but remain in the Static Content Item screen to continue editing. If the current action was creating a new Static Content Item it will now have been saved, and will appear on the Static Content Manager list. In addition, the current session now becomes an Edit action rather than the Add action it was previously. Once the editing session is complete, click Save as above.

Cancel: Clicking Cancel at any point ends the current creation session and returns the display to the Static Content Manager screen. Any changes made since the session commenced will be lost and the new Static Content Item will not have been created.

Close: Click Close at any point to end the current editing session and return to the Static Content Manager screen. Any changes made since the session commenced, or since the last time Apply was clicked, will be lost.

Help: Click the Help icon at any time to view this Help Screen.

Item Details 

Title: Enter a name for this Item as you would like it displayed at the top of the published page. It is possible to set whether this Title will display or not within the Parameter settings.

Title Alias: Enter a short name for this Item.

Text:

Every Static Content Item created must have content in this field. It will not be possible to save the Item otherwise.

WYSIWYG Editor:

The WYSIWYG (What You See Is What You Get) Editor is the means by which the text is entered into the Static Content Item.

Joomla! installs the TinyMCE WYSIWYG Editor Mambot by default. In addition, there is the option to use a plain text editor by selecting the No WYSIWYG Editor Mambot. The choice of editor can be made on a personal level by each User via their personal details page in the Front-end if allowed. The default can also be set Globally within the Global Configuration Menu.

Other WYSIWYG editors are also available.

Additional Features:

Pagination

Insert page breaks into lengthy documents to make them more easily readable without the User having to keep scrolling down the page. Locate the cursor at the point where the page break is to be inserted and enter the code mos_p-break-1. This functionality is controlled by the Mambot MOS Pagination. A contents table is then added to each page to aid navigation.

Alternatively, click the p-break_ic insert page break icon. The code mos_p-break-1 will appear in the text. This functionality is added by the Mambot MOS Pagebreak Editor Button.

Images

Insert image placeholders into a Static Content Item using the code mos_image. The Image is then configured within the Images Tab of the Parameters Menu. This functionality is added by the Mambot MOS Image.

Alternatively, click the Insert Image Iconinsert image icon. The mos_image code will appear in the text. This functionality is added by the Mambot MOS Image Editor Button.

See the Images Tab of the Parameters Menu below for details on configuring the image.

In addition to using the mos_image tag, most content editors have the ability to insert images as might be considered 'normal' in a word processor program. See the Help Screens on individual editors for details.{mospagebreak &title=Attributes Tabs - Publishing}

Attributes Tabs:

 static_content_attr_publishing  content_item_attr_images_ss  static_content_attr_parameters  static_content_attr_metadata  static_content_attr_link_to_menu
Publishing Images Parameters Meta Data Link to Menu

Publishing:

State: Advises the current status of the Static Content Item as to whether it is Published or Unpublished.

Published: Check this Check Box to Publish this Static Content Item. It will be available to be viewed at the Start Publishing Time and Date set below.

Access Level: Identify which User Group level can view this Static Content Item. Select from Public, Registered, or Special. See User Access Levels for further details on these.

Author Alias: If needed, enter an alternative name for the Author of this Static Content Item. This can be used for example, when the 'real' Author - whose User name would otherwise appear on the display page of this Item - wants to make an announcement as the Site Administrator. Another example would be when the Item is actually written by A N Other author but the Static Content Item is created by one of the administration team.

Change Creator: If needed, it is possible to change the name displayed as the original author of the Item. This might be of use, for example, when an Item has been substantially updated or rewritten by another author, and bears little, or no, resemblance to the original.

Ordering: Control where this Static Content Item will appear in Static Content Item Manager in the Back-end, and consequently its position in any Menu Item display in the Front-end. Select this position from the drop-down display of current Static Content Items contained in the Static Content Item Manager.

note711_smallNOTE: By default the new Static Content Item is placed at the top of the list. Its position becomes editable once it has been saved for the first time. Its position can also be changed within the Static Content Item Manager. The drop down box displays all Static Content Items in the Static Content Manager whether they are published or not.

Override Created Date: If a document is re-issued following a review, or it has been rewritten, for example, it is sometimes appropriate to change the Creation Date for the Item. 

Start Publishing: This is the date and time when the Static Content Item will first be viewable from the Front-end of the web site. Prior to this point - provided it has a Published status - it will show in the Back-end as Pending. There are two choices of action here; either enter the Date and Time manually into the field, ensuring that the format is the same as has been set for this parameter in the Global Configuration, or alternatively, click on the calendar_btn calendar icon and select the date from the calendar that is displayed.

Finish Publishing: This is the date and time when the Static Content Item will no longer be visible in the Front-end. After this date and time it will be displayed in the Back-end as Expired. As with the Start Publishing option above the same two methods of date and time entry exist.

After the new Static Content Item has been saved for the first time, an non-editable information pane will be displayed at the foot of this tab. It will contain the following information:

  • Content ID: The Identification Number that Joomla! (MySQL) has assigned to it.
  • State: Whether the Static Content Item is currently Pending, Published, Expired, or Unpublished.
  • Hits: The number of Hits (See: Page Impression Statistics ) that have been made on the full Static Content Item.
  • Reset Hit Count (button): The only interactive part of this section. This allows the Hits to be reset to 0 (zero). A warning dialogue box will pop up to check that this is the desired course of action.
  • Version: The number of times that this Static Content Item has been opened and saved since its original creation.
  • Created: The date and time upon which it was originally created.
  • Last Modified: The date and time when the Static Content Item was last amended/saved, and by whom.
  • Expires: Repeats a static representation of the date and time entry selected in the Finish Publishing field above.

Images:

MOSImage Control

As the title above suggests, this tab is the control section for any mos_image images that have been created throughout the Static Content Item.

Gallery Images: This is a display window of all the images currently available - by default in the top level of the joomla_root/images directory. Other folders and, therefore, images within the images directory will be viewable by changing to a sub-folder. See below.

Sub-folder: Select the folder that contains the required image from the drop down list of all folders contained within the joomla_root/images folder. The top level of the folder is represented by the '/' forward slash character (not - on this occasion - intended to represent the 'root' directory of Joomla!).

<<  >>: Select the required image and click the >> icon to transfer the image to the Content Images window. To remove an image from the Content Image window, click the << icon.

Content Images: The Content Images window displays all the images that have been selected to be displayed in the current Static Content Item. It must be remembered that the images will appear in the Static Content Item in the sequence they are displayed in this window. It is imperative, therefore, to adjust this list to ensure the right image is applied to the correct instance of themos_image tag in the Static Content Item.

Up and Down: Once an image has been copied from the Gallery Images listing to the Static Content Items listing it is necessary to ensure that it occupies the correct position in the list. This position must relate to the relative number of the mos_image tag in the Intro or Main Text fields of the editor. So, if the current mos_image tag is the fourth in the Static Content Item its actual image must be fourth in this list as well. Use the Up and Down buttons to move a selected image up, or down, the list to ensure it is in the correct location.

Sample Image: The Sample Image field shows a representation of the image currently highlighted/selected in the Gallery Images listing.

Active Image:The Active Image field shows a representation of the image currently highlighted/selected in the Content Images listing.

Edit the image selected:

The following fields allow specific elements of the image to be configured.

Source: This is the internal URL of the image relative to the joomla_root/images directory.

Image Align: Select Left, Right, or Center to set the position of the image in the display page of the Static Content Item in relation to text wrapping. For example if Left is selected the text will wrap the image and appear to the right of the image. If text wrapping is not required and the image should appear on its own line select None.

Alt Text: To assist in accessibility of the web site it is recommended (particular if aiming for a standards compliant web site) to enter an Alternative Text description for the image. If for any reason the image file is unavailable, or the user has a text only browser, or is using a text reader, they will not be left completely without an idea of what is being or should be displayed at this location.

Border: Decide whether a border is required around the image to be displayed. The number entered here will be translated into the thickness of the line around the image in pixels.

Caption: If a caption is required to describe the image being displayed, enter the desired text here.

Caption Position: If a caption is entered in the previous field, decide where, in relation to the images position, the caption will be displayed. Select Top for it to appear above the image, select Bottom for it to appear beneath the image.

Caption Align: Select None. Left, Right, or Center, to set the position of the caption in relation to the image. Selecting None will make the caption match the setting of the Image Alignment selected above.

Caption Width: It is a good idea to set this field to match the width of the image being displayed. Otherwise if the amount of text being displayed is quite lengthy it will alter the position of the image and mess up the layout of the displayed page. By setting this to the image width will ensure the text wraps to the next (and subsequent) lines.

Parameters:

Menu Image: Select a small image, from the drop down list of available images, to be placed to the left or right of the Menu Item Title in the Menu. Images must be located in the joomla_root/images/stories/ directory.

Page Title: Select Show or Hide to set whether the Page Title text entered above will appear at the top of their respective target page displayed in the Front-end of the web site.

Page Class Suffix: This field can contain a suffix that is to be applied to the CSS classes of this page. This allows individual page styling with relative ease. For example, if the suffix .bl (short for Blog) is entered here, all CSS code elements in this page will have .bl added to them. h2 becomes h2.bl. Separate entries in the CSS file of the template would then be applied as entered.

Back Button: Set whether there is a Back navigation button inserted at the base of the target page being displayed. Options are Use Global (the setting made for the whole site in the Global Configuration), Hide, or Show. The Global site settings are overridden by these individual page settings.

Item Rating: Use this feature to set whether the Item Rating images are displayed in Static Content Items on the target page display. Select Use Global to follow the Global rule for the web site. Select Yes to override the Global rule and always make the Item Rating appear. Select No to override the Global rule and never show the Item Rating. This feature does not control the function of enabling rating.

Author Names: Use this feature to set whether the name of a Static Content Item's Author is displayed in the Static Content Item on the target page display. Select Use Global to follow the Global rule for the web site. Select Yes to override the Global rule and always make the Author Name appear. Select No to override the Global rule and never show the Author Name.

Created Date and Time: Use this feature to set whether the the date and time that this Static Content Item was created are displayed in the Static Content Item on the target page display.  Select Use Global to follow the Global rule for the web site. Select Yes to override the Global rule and always make the Created Date and Time appear. Select No to override the Global rule and never show the Created Date and Time.

Modified Date and Time: Use this feature to set whether the the date and time that this Static Content Item was last modified are displayed in the Static Content Item on the target page display.  Select Use Global to follow the Global rule for the web site. Select Yes to override the Global rule and always make the Modified Date and Time appear. Select No to override the Global rule and never show the Modified Date and Time.

PDF Icon: Use this feature to set whether the PDF icon is displayed in Static Content Items on the target page display. The PDF Icon (sometimes also just represented in plain text) allow the download of the Static Content Item as a PDF file. Select Use Global to follow the Global rule for the web site. Select Yes to override the Global rule and always make the PDF Icon appear. Select No to override the Global rule and never show the PDF Icon.

Print Icon: Use this feature to set whether the Print icon is displayed in Static Content Items on the target page display. The Print Icon causes a new browser window to open with the basic text content of the Static Content Item displayed without any of the web site graphics or design showing. This allows a User to conveniently print the Item. Select Use Global to follow the Global rule for the web site. Select Yes to override the Global rule and always make the Print Icon appear. Select No to override the Global rule and never show the Print Icon.

E-mail Icon: Use this feature to set whether the E-mail Icon is displayed in Static Content Items on the target page display. The E-mail Icon permits the ever present 'Mail to a Friend' facility to be used allowing a copy of a particular Static Content Item to be sent to an e-mail address. Select Use Global to follow the Global rule for the web site. Select Yes to override the Global rule and always make the E-mail Icon appear. Select No to override the Global rule and never show the E-mail Icon.

note711_small NOTE: Changes made to the Parameters within this Menu Item, only affect this instance of the Static Content Item display and does not alter any Global rules that may be set within the Global Configuration.

Meta Info:

In addition to the fields below in which to set the Meta Data for this particular Static Content Item, there is also an option within the Global Configuration -> Metadata Tab, to set a web site wide collection of Keywords and Descriptions that are then automatically appended to every Static Content Item. These avoid the necessity of repeating the same entry of words and ensures a minimum set of Meta Data wording is always used.

Description: This field corresponds to the Meta Tags in the Head of an HTML page. Enter a brief description as to the purpose of the Static Content Item. This information is used by some Search Engines which then categorise the page accordingly.

Keywords: Enter a number of Meta Keywords that reflect the substance of the Static Content Item. This information is used by some Search Engines which then categorise the page accordingly. In addition, Keywords are central to the functioning of the Related Items Module.

Link to Menu:

The fields in this Tab will create a Link - Static Content Item Menu Item in the Menu selected.

Select a Menu: Select the Menu, on which the new Link - Static Content Item will be created, from the displayed list of existing Menus in the Front-end of the web site.

Menu Item Name: Enter a name for the new Menu Item. This will be the entry that will be visible within the Menu itself.

Link to Menu Button: Once all the fields above have been satisfactorily completed, click thelink_to_menu_btn Link to Menu button to commit the changes to the system and create the new Menu Item.

note icon NOTE: Using a Link - Static Content Item, Menu Item is the only way that Static Content Items can be displayed in the Front-end of Joomla!. They are not available in Blogs, Tables, or Lists in a standard installation.

Existing Menu Link: If the Static Content Item has previously been linked to an existing Menu the details of this will be displayed in this field. The current change will appear in this field once thelink_to_menu_btn button has been clicked.

Related Information:

 TinyMCE WYSIWYG Editor  User Access Levels  Global Configuration
 No WYSIWYG Editor  MOS Image Editor Button  Related Items Module
 MOS Pagination  Calendar  Link - Static Content Item
 MOS Pagebreak Editor Button  Page Impression Statistics  Static Content Manager
 MOS Image    

note icon NOTE: If you have any comments or suggestions regarding this Help screen then please post them in the Suggestions, Modifications, and Corrections forum in the User Documentation Work Group.

Thank you!

 

The User Documentation Team

Last Updated ( Wednesday, 04 July 2007 )