Joomla

To view and disable Joomla! users:

1. Log into the back end "Administrator" interface of your website.
2. Navigate to Users ---> Manage.
3. Click the Filter Options button to reveal filters that can be used to search for users by state (enabled or disabled) or by group. 
4. Once a user is found, check the box to the left of their name. (Please keep in mind that some users may be SAS-IT staff. When in doubt, submit an SAS-IT REQUEST.)
5. Select Blockfrom the Actionsdropdown menu. 
6. Check the box to the left of the user's name.
7. Select Batchfrom the Actionsdropdown menu. 
8. For "Select Group," select "Public"
9. For "Select Action," select "Move to Group"
10. Click Process.

To create a caption

1. Select an image or media placeholder in the editor
2. The Insert / Edit Caption button will become enabled. Click the button to open the Captions dialog.
3. Some fields will be filled with some of the image properties
   1. The Text field in the Text tab will be filled with the image alt or title attribute value
   2. The Alignment in the Container tab will be selected based on the image's alignment.
   3. The Margin fields in the Container tab will be filled with the image's margin styles, if any.
4. Set the Text and Container options as required. A preview of the caption will be displayed in the Preview section of the dialog.
5. Click the Insert button to create the caption.

The caption text can be edited as normal in the editor. For example in the animation below, after the caption has been created, the caption text is selected and an italic format is applied.

 To edit a caption

1. Click on the image that has the caption in the editor.
2. The Insert / Edit Caption button will become enabled. Click the button to open the Captions dialog.
3. Edit the caption properties as required.
4. Click on the Update button to update the caption and close the dialog.

To delete a caption

1. Click on the image that has the caption in the editor.
2. The Delete Caption button will become enabled. Click the button to delete the caption.

The procedure explains how to add a "Custom" module in Joomla! using the Administrator interface. A "Custom" module is a block of formatted text that can be configured to appear when one or more menu items are accessed.

A custom module allows you to add custom text and/or an image and place it in a position on the website.

Create a new Module

1. In the Joomla! back-end (Control Panel), navigate to Extensions > Site Modules, then click the New Button to create a new module
   
2. For "Select a Module Type," select Custom:
   
3. Enter the name of your module in the "Title *" field (see #1 below).
4. (Optional) click "Hide" under "Show title" selection to the right if the module title should not be shown (see #2 below).
5. For "Position," click the dropdown menu, and select the desired module position.  For example, to display the module to the left of the content area, select "Sidebar-left [sidebar-left]" (see #3 below).
6. Under the formatting toolbars, enter the text that you would like to appear in the module.  You can format the text using the buttons on the editor toolbars (see #4 below).
7. Click the "Menu Assignment" menu to specify which menu items will display your module (see #5 below).
8. If the new module should appear on all pages, leave "On all pages" selected. If not, go to the next section, "Assigning the module to specific menu items."
   

Assigning the Module to specific menu items

If the module should appear only when one or more specific menu items are accessed, do the following:

• On the "Menu Assignment" tab, click the dropdown box to the right of Module Assignment and select "Only on the pages selected" (see #1 below).
• For Menu Selection, click None to the right of "Assign to Menu Items" (see #2 below).
• Click the check boxes for any menu items that should display the module when clicked (see #3 below).

Saving the Module

• To save changes and continue editing the module, click the Savebutton to the upper left of the web page.
• When you are done editing the module, click "Save & Close" to the upper left to save your new module. 

Overview

JEvents is a third-party extension for Joomla! that allows you to add event information in either a calendar or list format.  As you create events, they will appear on your website in JEvents menu items or modules that have been configured to display events from the appropriate categories.

Procedure

1. Login to the Joomla! Administrator back-end.
2. Click on "Components > JEvents"
   
   
   
   
3. At the JEvents Dashboard, hover the mouse over the left sidebar (or top menu, if the left sidebar does not appear), then select Manage Events.
   .
   1. JEvents left sidebar (larger browser sizes):
      
      
   2. Top menu (smaller browser sizes):
      
      
4. Click the "New" button:
5. Enter a title for the event in the "Title" field (see #1 below).
6. If your website has more than one calendar, select the appropriate one from the "Events calendar" dropdown menu (see #2 below).
7. For Categories,select one or more categories that should display your event (see #3 below).
8. Enter a short description of your event in the "Description" text box.  Note that you can format your description the same way you would format an article (see #4 below).
9. Enter the location of your event in the "Location" field (found under the "Description" text box).
   
   
   
   
10. Click on the "Calendar" tab under the "JEvents" logo (see #1 below).
11. Click the mini-calendar icon below "Start date" and select a start date for your event (see #2 below).
12. Type a Start Time in the Start Time field and select "am" or "pm" (see #3 below).
13. If the event will span more than one day, click the mini-calendar icon below "End date" and select an end date for your event.
    
14. Type an End Time in the End Time field and select "am" or "pm" (see #4 below).
15. Click "Save & Close" (see #5 below).
    
    

Overview

JEvents is a third-party extension for Joomla! that allows you to add event information in either a calendar or list format.  As you create events, they will appear on your website in JEvents menu items or modules that have been configured to display events from the appropriate categories.

Procedure

1. Login to the Joomla! Administrator back-end.
2. Click on "Components > JEvents"
   
   
   
   
3. At the JEvents Dashboard, hover the mouse over the left sidebar (or top menu, if the left sidebar does not appear), then select Manage Events.
   
   JEvents left sidebar:
   
4. Click the "New" button:
5. Enter a title for the event in the "Title" field (see red box below).
6. For Categories,select one or more categories that should display your event (see green box below).
7. Enter a short description of your event in the "Description" text box.  Note that you can format your description the same way you would format an article (see blue box below).
8. Enter the location of your event in the "Location" field (found under the "Description" text box).
   
   
9. Click on the "Calendar" tab under the "JEvents" logo (see red box below).
10. Click the mini-calendar icon below "Start date" and select a start date for your event (see orange box below).
11. Type a Start Time in the Start Time field and select "am" or "pm" (see green box below).
12. If the event will span more than one day, click the mini-calendar icon below "End date" and select an end date for your event.
    
13. Type an End Time in the End Time field and select "am" or "pm" (see blue box below). If there is no definitive end time for your event, check the 'No specific end time' box. 
14. Click "Save & Close" (see yellow box below).
    
    

1. Log into the Administrator interface using your NetID credentials.
2. Find the article you want to edit and click on its title.
3. Choose where you would like your image placed, then click the Insert/Edit Image button from the WYSIWYG editor:
   
   
4. Navigate to the folder where the image is located (or, for a new image, where it should be saved) using the "Folders" pane to the lower left.  If you are adding a new image, click the Upload button to the right:
   
   
5. If you clicked Upload, choose the Browse button at the bottom of the "Upload" window and navigate to the location of the image on your computer (see #1 below).  Alternately, you can drag and drop images to the 'Drop files here' area (see #2 below):
   
   
   
   
6. You may upload multiple images by holding the [Shift] key as you select the images.  Click Upload (see #3 above) when you have finished selecting images.
7. Back at the Image Manager window, select the image to be added to the article:
   
   
8. Set the image properties (dimensions, border, margins, etc) as needed:
   
   
9. Alternate Text:  Be sure to add some descriptive text to the Alternate Text (alt text) field.  It is an important feature for accessibility. This is used to enable screen readers to portray the image as text.
10. Image Caption:  To add an image caption, click the "Advanced" tab, add the caption text to the "Title" field, and add the word "caption" to the classes field:
    
    
11. Click Insertwhen all properties have been set.
12. Save & Close the article.

1. Log into the Administrator interface using your NetID credentials.
2. Find the article you want to edit and click on its title.
3. Choose where you would like your image placed, then click the Insert/Edit Image button from the WYSIWYG editor:
   
   
4. Navigate to the folder where the image is located (or, for a new image, where it should be saved) using the "Folders" pane to the lower left.  If you are adding a new image, click the Upload button to the right:
   
   
5. If you clicked Upload, choose the Browse button at the bottom of the "Upload" window and navigate to the location of the image on your computer (see #1 below).  Alternately, you can drag and drop images to the 'Drop files here' area (see #2 below):
   
   
   
   
6. You may upload multiple images by holding the [Shift] key as you select the images.  Click Upload (see #3 above) when you have finished selecting images.
7. Back at the Image Manager window, select the image to be added to the article:
   
   
8. Set the image properties (dimensions, border, margins, etc) as needed:
   
   
9. Alternate Text:  Be sure to add some descriptive text to the Alternate Text (alt text) field.  It is an important feature for accessibility. This is used to enable screen readers to portray the image as text.
10. Click Insertwhen all properties have been set.
11. Save & Close the article.

This procedure describes how to add images to Media on Joomla! 3.x web sites.

1. Login to your web site using the Administrator Interface.
2. In the Joomla! Administrator , click on Media to the left (found under CONTENT; see #1 below).  If you are not at the Control Panel, you can select Media from the center console  menu (see #2 below):
   
3. Click on the folder where you want to add the image.  You can either select from the small folder icons on the left (see #1 below), or the larger folder icons to the right (see #2 below):
4. Once you have selected the folder where you want to upload the image, click the Upload button to the upper left: 
5. Use the File Upload window to browse to your image file.  When you find the image, click once on the image, then click Open: 
6. If the upload was successful, you will see the message Item Uploaded above the gallery of images, and your image should now appear in the gallery:
7. You can now insert your image into an article.

This procedure describes how to add images to Media on Joomla! 3.x web sites.

1. Login to your web site using the Administrator Interface.
2. In the Joomla! Administrator , click on Media to the left (found under CONTENT; see #1 below).  If you are not at the Control Panel, you can select Media from the center console  menu (see #2 below):
   
3. Click on the folder where you want to add the image.  You can either select from the small folder icons on the left (see #1 below), or the larger folder icons to the right (see #2 below):
4. Once you have selected the folder where you want to upload the image, click the Upload button to the upper left: 
5. Use the File Upload window to browse to your image file.  When you find the image, click once on the image, then click Open: 
6. If the upload was successful, you will see the message Upload Complete above the gallery of images, and your image should now appear in the gallery. 
7. You can now insert your image into an article.

Overview

It is useful to display left side menu modules on your site pages. These modules remain visible after a dropdown menu item on the Main Menu is clicked.

Procedure

1. In the Joomla! control panel (back end), navigate to Extensions > Site Modules, then click the New button to create a new module. 
2. For "Select a Module Type," select "Accordeon Menu CK"
3. Enter a title for the module in the "Title" field. For example, if you want to display a menu of the dropdown menu items under "People" on the Main Menu, enter "People" for the title.
4. Configure Module Options:
   • For "Show Title," click Show (see #1 below)
   • For "Position," select "sidebar-left" (this is the left side of the web page) (see #2 below)
   
5. Click the "Menu Assignment" tab:
   
   1. Change "Module Assignment" to "Only on the pages selected"
   2. For "Menu Selection," click the "None" link shown after "Assign to Menu Items"
   3. Select the menu items corresponding to the dropdown menu item list where this module should be displayed.  For example, if you are creating a menu module for the "Test Menu" dropdown list, check off the menu items under "Test Menu Item:"
      
6.  Click the "Source" tab
   1. Select Menu = select the "Main Menu"
   2. Base Item = "Current"
   3. Start Level = "2"
7.  Click the "Effects" tab
   1. Enable Link redirect on parent item = "Yes" 
8. Click the "Styles" tab

   1. Style > click "Select", then select "SAS - Left Side Menu"

9. Click Save & Close to the upper left

Overview

If your article has a significant amount of text, and you want to display multiple articles on the same page using a Category Blog, you can break up the article by inserting a "Read More" separator line within the article.  Anything above the "Read More" line will be displayed as "teaser text" on the ‘blog view’, and the entire article will be displayed once you click Read More.

Procedure

1. Find the article you want to edit.
2. Click inside the article to place the cursor where the Read More link should appear - for example, at the beginning of the second paragraph within the article (see #1 below).
3. Click the Read More button below the content area (see #2 below).
   
   

   

4. A horizontal line will appear within the article where you placed the cursor (see below):
   
5. The text above this line is considered the "Intro Text" (or "teaser text") and will appear when the article is shown via a Category Blog menu item (see #1 below).  The text below the horizontal line will initially be hidden in the Category Blog, but will appear once the Read More button is clicked (see #2 below).
   
6. Save & Close the article.

Alternative text ("alt txt") provides the textual equivalent of an image to the web page. The description you write should be short and concise, but accurately describe the image content. Implementing alternative text allows screen readers to describe an image that would otherwise be skipped over to those with visual or other cognitive impairments. For this reason it is required that all images must implement proper alternative text.

To add alternative text to an image follow this procedure:

1. Find the article containing the image that needs "alt txt" and click on its title.
2. Click once on the image inside the article's Content area, then click the Insert image button in the WYSIWYG editor:
   
   
   
   
3. Enter a short description of the image in the "Alternate Text" field (see #1 below):
   
   
   
   
4. Click Update to the lower right of the "Image Manager" window (see #2 above)
5. Save the article. It is okay that you do not see the alternative text; it will only show up if disable images in your browser.

It is possible to store, restore and compare changes that you have made in an article using Joomla!'s "Versions" feature.  Prior to using Versions, this functionality must be enabled.  If you do not see the Versions button when editing an article, please create a REQUEST and we can turn it on for you.

Once Versions are turned on, Joomla! does not automatically save versions.  You need to click the Save button before editing your article to create a version of the article that can be restored.  Every time you click Save, a new version will be saved (up to a maximum number, which is set at 10 by default).

Finding the Versions button

Joomla! Administrator (back end)

The Versions button is in the row of buttons above the article editor:

Joomla! Front End Editor

The Versions button is below the article editing area:

Restoring an article version

1. When editing an article, click the Versions button (see above for the location of the button)
2. Click the check box corresponding to the date and time that the version of the article you want to restore was saved (see #1 below)
3. Click the Restore button, which should be the first button in the row of buttons at the top of the "Versions" popup window (see #2 below):
   
   
4. The article will be restored to the version you selected.

Comparing article versions

1. When editing an article, click the Versions button.
2. Click the check boxes for the article versions you would like to compare (see #1 below)
3. Click the Compare button (see #2 below):
   
   
4. A "Compare View" popup window will appear, showing you the differences between the versions:
   
   

Setting a version to be kept forever

 If there is a version of an article that you want to save forever, you can do the following:

1. When editing an article, click the Versions button.
2. Click the check boxes for the article version you would like to keep forever (see #1 below)
3. Click the Keep On/Off button (see #2 below):
   
   
   
   
   
4. The "No" in the "Keep Forever" column will change to "Yes".

Overview

By default, Joomla! assigns a new module to all pages, which may not always be appropriate.  This procedure explains how to restrict the display of a module to one or more menu items using the Administrator interface.  The module will only appear when the selected menu items are accessed. 

Assigning the Module to specific menu items

1. In the Joomla! back-end (Control Panel), navigate to Extensions > Site Modules
2. Click the title of the module
3. Click the "Menu Assignment" tab
4. Click the dropdown box to the right of Module Assignment and select "Only on the pages selected" (see #1 below).
5. For Menu Selection, click None to the right of "Assign to Menu Items" (see #2 below).
6. Click the check boxes for any menu items that should display the module when clicked (see #3 below).

Saving the Module

• To save changes and continue editing the module, click the Savebutton to the upper left of the web page. 
• When you are done editing the module, click "Save & Close" to the upper left to save your new module. 

The procedure explains how to edit articles from the back-end administrator interface in Joomla! 3.x

1. Log on to your site using the Administrator Login URL for your web site.
2. Find the article you wish to edit.
3. Click the title of the article to edit it:


4. Modify the text in the text area (see #1 below) under the formatting (WYSIWYG) toolbars as required.
5. Use the icons on the formatting toolbars (see #2 below) to format your text.  The function of each button on the toolbar will be displayed as you position the mouse cursor over it.  You can also find a guide to the functionality of all the editing buttons here.

6. When copying and pasting text from other applications, use either the Paste clipboard or the Paste as Plain Text clipboard.
7. When you're done editing your article, save it by clicking the Save & Closebutton to the upper left (see #3 above).
8. To cancel any changes you have made and close the article, click the Closebutton (see #4 above).

The procedure explains how to edit articles using the Editor interface in Joomla!

1. Log on to your site using the Editor Login URL for your web site.
2. Browse to the article you wish to edit.
3. Click the Edit icon or link to edit your article:
4. Modify the text in the text area (see #1 below) under the formatting (WYSIWYG) toolbars as required.
5. Use the icons on the formatting toolbars (see #2 below) to format your text.  The function of each button on the toolbar will be displayed as you position the mouse cursor over it.  You can also find a guide to the functionality of all the editing buttons here.

6. When copying and pasting text from other applications, use either the Paste clipboard or the Paste as Plain Text clipboard.
7. When you're done editing your article, save it by clicking the Savebutton to the upper right (see #3 above).
8. To cancel any changes you have made and close the article, click the Cancel button (see #4 above).

Instructions on how to change the category of an article through the Joomla adminstrator back-end:

1. Log in to the Administrator back-end.

2. Locate Article by clicking on Content then Articles.

3. Click on the title of the article you wish to edit.

4. On the right of the page you will see the article's category. To change the article, click on the Category dropdown menu to the right of the text areat. Select the most appropriate category. If there is no appropriate category, you can close the article, create your category, and then return to edit the article.

5. Once you are satisfied with your updates, click on Save to save your changes and continue editing the article, or Save & Close to save the article and close the article editing page.

This procedure describes how to add a security CAPTCHA to a form using ChronoForms version 5.  

Getting Started: Select the form

• Log into the Joomla! administrator page for your web site
• Click on Components > ChronoForms5:
  
  
• Ignore the message "Your ChronoForms installation on webdevel.sas.rutgers.edu is NOT validated."  Chronoforms will still work.
• In Forms Manager, click on the name of the form you want to add a CAPTCHA to.
• Click on the Designer tab (see #1 below).

Add the CAPTCHA

• Drag the Captcha button under Basic (see #2 below) to the light blue designer area under Widgets (see #3 below):

• Click and hold the Drag button for the Captcha element so that it appears above the "Submit" button element (see #1 below):

• Click the Edit button for the Captcha element (see #2 above).
  
  • Click the Validationtab (see #1 below)
  • Change Required to "Yes" (see #2 below)
  • Click Save and Close to the lower right (see #3 below):

• Click on the Setuptab (see #1 below).
  
  • Click Captcha (see #2 below).
    
  • Change Enabled to "Yes" (see #3 below).
    
  • (Optional) Modify the message in the Error field (see #4 below).
  • Click Save and Close to the upper right (see #5 below):

What's next?

If you haven't already, you can configure your form to email the data to one or more people. 

You can also configure your form to save information to a database.

Once you configure your form to collect data, you can embed it within an article.

This procedure describes how to set up a simple form using mostly text fields using ChronoForms version 5.

Getting Started: Select a form

• Log into the Joomla! administrator page for your web site
• Click on Components > ChronoForms5:
  
  
• Ignore the message "Your ChronoForms installation onwebdevel.sas.rutgers.edu is NOT validated."  Chronoforms will still work.
• In the Forms Manager, click the name of the form you would like to enable email for:
  
  
• Click on the Designer tab (see #1 below).
• Take note of the Field Names of the form fields that are used to collect the submitter's name and email address. The Field Name is shown in the upper left corner of the field in a blue box (see #2 below).  You may have separate fields collecting "First Name" and "Last Name" - if so, take note of both field names.
• Click on the Setup tab (see #3 below).
  
  
  
  
• Click the Email (0) option on the green action selector bar (see #1 below).
• Under Basic options, enter "email" for Action Label (see #2 below).
• Change the Enabled dropdown selection to "Yes" (see #3 below).
• For To enter a list of email address (separated by commas) that will receive the data entered into the form (see #4 below).
• For Subject enter a subject for the email that will be sent when the form is complete (see #5 below).
• Change Template Generationto "Auto" (otherwise, you will need to manually configure the template for outgoing emails every time you edit the form).
• Click the Advanced tab above the list of Basic options (see #6 below).
  
  
  
  
• Under the Advanced options, enter the field name containing the submitter's email address in the Dynamic Tofield (see #1 below). This will send a copy of the email to the person submitting to the form.
• Enter the field name or names containing the submitter's name in the Dynamic from name field (see #2 below).  For example, if the form asks the submitter to enter their full name in a field called "name", enter "name" here.  If the form asks the submitter to enter the first name and last name in separate fields called "firstname" and "lastname", enter "firstname lastname" here.
• Enter the field name containing the submitter's email address in the Dynamic from email field (see #3 below):
  
  
  
  
• Click the Thanks Message (4) option on the green action selector bar (see #1 below).
• Enter a message in the Message Content text box (see #2 below).  This message will be displayed when someone submits the form.

Publishing your form

If you haven't already published your form, please do the following:

• Click the General button to the upper left of the form (see #1 below).
• Change the Enabled dropdown selection to "Yes" (see #2 below):

Saving your form

Click "Save and Close" to the upper right:

What's next?

If needed, you can configure your form to save information to a database.

You can also embed your form within an article.

This procedure describes how to save the data from a form you have updated to a new database table, using ChronoForms version 5.  This step is necessary if you add new fields to a form that saves its data to a table.  A new table needs to be created in order to capture data entered into the new fields.

Backup the old data table

• Log into the Joomla! administrator page for your web site.
• Ignore the message "Your ChronoForms installation onwebdevel.sas.rutgers.edu is NOT validated."  Chronoforms will still work.
• In Forms Manager, find the form and select the existing table from the dropdown menu for Connected Tables
• Click Backup tableto export the entire form to a CSV file.
• Save that file and open it to verify that all the data has been saved.
• Click Cancel to return to Forms Manager.

Creating a new data table

• Back in the Forms Manager, check the box to the left of the form that you would like to configure to save data.
• Click the Create table button at the top.
• At the Create table page, replace the "#__" portion of the Table Name with the actual database table prefix for your web site (e.g. j17_ or j25_).
• (Optional) Clear the check boxes for any fields that you do not need to save into the database (for example, "captcha"). Do not unselect the "cf_id" field since it is the primary key!
• Click Save to the upper right. 

Modify the form to save data to the new table

• In Forms Manager, click on the name of the form with the new table.
• Click the Setup tab.
• Click Data Save (11).
• Verify that "Enabled" = "Yes"
• For "Table name" select the newly created table.
• Click Save.
• (Optional) Click the DB Viewer tab at the top and enter field names. They will be added as columns to the table's list view for this form. Without doing this, the table list preview will only show an ID number and the "Created Date/Time". Doing this makes the list show useful information.
• The format to use here is (one entry per line): field_name=whatever column heading you want. The field name comes from the field settings. It should not contain any spaces or special characters. The column heading can be different.
• Click Save and Close.