modules

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

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

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. 

Overview

You can use an "Articles - Category" module to display a list of articles from a category in a module position on your website.

Procedure

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 "Articles - Category" (not "Articles - Categories"):
   
3. Enter a title for your module in the "Title" field.
4. 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]".
5. Click the "Menu Assignment" menu to specify which menu items will display your module
   • If the new module should appear on all pages, leave "On all pages" selected. If not, refer to Assigning a Module to one or more menu items.
6. Click the "Filtering Options" tab (see #1 below):
   • For "Count," select the number of articles to be displayed; to display all articles from the category, leave this as "0" (see #2 below)
   • Change "Featured Articles" from "Show" to "Hide" to hide featured articles; or to "Only" to display only featured articles (see #3 below)
   • Click in the "Category" field and select one or more categories whose articles should be displayed in the module (see #4 below)
   • If articles from a categories' subcategories should be displayed, change "Child Category Articles" to "Include" (see #5 below)
     
     
7. Click the "Ordering Options" tab.
8. Select the option from "Article Field to Order By" based on how the articles should be ordered within the module.
   • For example, selecting "Article Field to Order By" to "Random" will display the articles in a random order every time the module is displayed.
   • To set your own order for the articles, select "Article Order," then refer to the procedure "Re-ordering Articles"
     
     
9. Click the "Grouping Options" tab.
   • If you want the articles to be grouped within the module, select an option from the "Article Grouping" drop-down menu (see #1 below).
     • For example, selecting "Category" will group the articles into their subcategories.
   • Leave "Grouping Direction" as "Ascending" unless the article groups should be displayed in reverse order (see #2 below).
     
     
10. Click the "Display Options" tab.
    • By default, "Linked Titles" is set to "Yes," meaning you can click the article titles to be redirected to the corresponding articles. 
    • Additionally, you can display other elements from the articles, such as the date, category, intro text or a Read More link.
    
11. When done, click Save & Close. 

Overview

An "Articles - Newsflash" module can display text from one or more articles.  The ordering can be set to random, so that each time you visit the page where the module is displayed, it will show content from a different article.

1. In the Joomla! back-end (Control Panel), navigate to Extensions > Modules, then click the New Button to create a new module:
   
   
2. For "Select a Module Type," select "Articles - Newsflash"
   
3. Enter the name of the module in the "Title" field.
4. Under "Position," click the dropdown menu, and select the desired module position.  For example, to display the module to the right of the content area, select "Sidebar-b [sidebar-b]"
5. Configure the options for the module:
   • For "Category," select the category or categories whose articles will be displayed (see #1 below)
   • Change "Show Images" to "Yes" if images from the articles should be displayed in the module (see #2 below)
   • For "'Read more...' Link", click "Show" if you would like to display a "Read more" link that links to the full article (see #3 below)
   • For "Number of Articles," enter the number of articles to be displayed by the module (see #4 below)
   • For "Order Results," select how the articles should be ordered (see #5 below).  The options are:
     • Published Date
     • Created Date
     • Modified Date
     • Ordering (i.e. article ordering)
     • Hits (number of hits)
     • Random
   • 
     
6. By default, Joomla! will assign the new module to all pages.  To display the module only on selected pages, follow the documentation for Assigning a Module to one or more menu items.
7. When done, click Save & Close to the upper left: 

Overview

An "Articles - Newsflash" module can display text from one or more articles.  The ordering can be set to random, so that each time you visit the page where the module is displayed, it will show content from a different article.

1. In the Joomla! back-end (Control Panel), navigate to Extensions > Modules, then click the New Button to create a new module:
   
   
2. For "Select a Module Type," select "Articles - Newsflash"
   
3. Enter the name of the module in the "Title" field.
4. Under "Position," click the dropdown menu, and select the desired module position.  For example, to display the module to the right of the content area, select "Sidebar-Left [sidebar-left]"
5. Configure the options for the module:
   • For "Category," select the category or categories whose articles will be displayed (see #1 below)
   • Change "Show Images" to "Yes" if images from the articles should be displayed in the module (see #2 below)
   • For "'Read more...' Link", click "Show" if you would like to display a "Read more" link that links to the full article (see #3 below)
   • For "Number of Articles," enter the number of articles to be displayed by the module (see #4 below)
   • For "Order Results," select how the articles should be ordered (see #5 below).  The options are:
     • Published Date
     • Created Date
     • Modified Date
     • Ordering (i.e. article ordering)
     • Hits (number of hits)
     • Random
   • 
     
6. By default, Joomla! will assign the new module to all pages.  To display the module only on selected pages, follow the documentation for Assigning a Module to one or more menu items.
7. When done, click Save & Close to the upper left: 

Uploading the Video

This procedure assumes the video has already been uploaded to YouTube.  You will need the URL for the video in order to proceed. 

For information on having your video uploaded to YouTube, please consult Video Hosting Options at Rutgers.

Displaying the Video

Sample Video Display

Once you have embedded the video in your article or module, it will look something like this:

Working with hosting services other than YouTube

• Vimeo and other third-party video hosts
  The process is similar to embed a video hosted on a website other than YouTube.  Consult the AllVideos documentation to get the correct tags to use (in place of the tags "{ youtube }" and "{ /youtube }" referenced in the above procedure).
• Kaltura
  Kaltura-hosted videos can be displayed on the site using the embed code from Kaltura. 

• Video Included: Video Included

Requirements

This procedure assumes the video has already been uploaded to YouTube.  You will need the URL for the video in order to proceed. 

For information on having your video uploaded to YouTube, please consult Video Hosting Options at Rutgers.

Displaying the Video

Sample Video Display

Once you have embedded the video in your article or module, it will look something like this:

Working with hosting services other than YouTube

• Vimeo and other third-party video hosts
  The process is similar to embed a video hosted on a website other than YouTube.  Consult the AllVideos documentation to get the correct tags to use (in place of the tags "{ youtube }" and "{ /youtube }" referenced in the above procedure).
• Kaltura
  Kaltura-hosted videos can be displayed on the site using the embed code from Kaltura. 

Overview

A custom module contains some combination of text, images, and links.  Editing a custom module is very similar to editing an article.

Example

In the below screenshot, "Contacts" is a custom module that contains text and links. The title of the module usually appears in a large font above the content within the module.

Procedure

1. In the Joomla! back-end (Control Panel), navigate to Extensions > Sites Modules, then click the New Button to create a new module:
2. For "Select a Module Type," select "Custom"
   
3. Under the formatting toolbars, edit the text that appears in the module (see #1 below). You can format the text using the buttons on the editor toolbars (see #2 below).
   
   
4. When done, click Save & Close. 

{slider • Rutgers Maps}

When embedding Rutgers Maps (the way that is possible with Google and other maps) is possible, instructions will be posted here.

{slider title ="• Google Maps" open="true"}

1) Embed Google map of unit's address within Custom module and assign to Contact Us menu item:

• Go to Google Maps and enter the building address.
• Click Share.
• Click Embed Map.
• Copy the embed code for the iframe.

2) Create a new Custom module called "Contact Us - Google Map" 

• Change "Show Title" to "Hide" 
• Enter the unit's address at the top of the module after the text "Main office:" 
• Link the address to its URL as it appears on Google Maps. 
  Example: For  "604 Allison Road, Piscataway, NJ 08854-8082" the link would be:

<a href="https://www.google.com/maps/place/604+Allison+Rd,+Piscataway+Township,+NJ+08854/@40.5247824,-74.4669924,17z/data=!3m1!4b1!4m5!3m4!1s0x89c3c70d50b175d7:0x495c76a64748b442!8m2!3d40.5247824!4d-74.4648037" target="_blank" rel="noopener">

• If asked to add "mailto:" to the URL, click No.
• Switch to the Source Code editor and paste the embed code for the Google Map below the address.
• Modify the code to change the iframe's width to 100% and height to 400.
• Add the following paragraph tags (with aria code) before and after the embedded map:

<p aria-hidden="true" aria-role="presentation">
    <iframe src="/actual-map-goes-here" width="100%" height="400" style="border: 0;" frameborder="0" allowfullscreen="allowfullscreen"></iframe>
</p>

• For Position, select "extension-a".
• Assign the module to the Contact Us menu item on the Main Menu.
• Save & Close the module.

{/sliders}

Get embed code from Google Maps

• Go to Google Maps and enter the building address.
• Click Share.
• Click Embed a Map.
• Click COPY HTML to copy the embed code for the iframe.

Create a new Custom module called "Contact Us - Google Map" 

• Go to Extensions > Site Modules
• Click New
• Select "Custom"
• For "Title," enter  "Contact Us - Google Map"
• Change "Show Title" to "Hide" 
• Enter the unit's address at the top of the module after the text "Main office:" 
• Link the address to its URL as it appears on Google Maps. 
  Example: For  "54 Joyce Kilmer Ave., Piscataway, NJ 08854" the link would be:

https://www.google.com/maps/place/54+Joyce+Kilmer+Ave,+Piscataway,+NJ+08854/@40.5219797,-74.4374585,16z/data=!3m1!4b1!4m6!3m5!1s0x89c3c795d438197b:0x48525eb0c8d3a54c!8m2!3d40.5219797!4d-74.4348782!16s%2Fg%2F11cskq_bsm?entry=ttu

• If asked to add "mailto:" to the URL, click No.
• Switch to the "Code" tab and paste the embed code for the Google Map below the address.
• Modify the iframe code to change the iframe's width to 100% and height to 400.
• Modify the iframe code to include the attribute: sandbox="allow-scripts allow-same-origin"
• Modify the iframe code to include a title attribute, and set title equal to the address (for example, title="54 Joyce Kilmer Ave., Piscataway, NJ 08854")
• Add paragraph tags  before and after the embedded map.
• Example:

<p>
    <iframe src="https://www.google.com/maps/embed?pb=!1m18!1m12!1m3!1d6065.774814012168!2d-74.43745848819128!3d40.52197967130358!2m3!1f0!2f0!3f0!3m2!1i1024!2i768!4f13.1!3m3!1m2!1s0x89c3c795d438197b%3A0x48525eb0c8d3a54c!2s54%20Joyce%20Kilmer%20Ave%2C%20Piscataway%2C%20NJ%2008854!5e0!3m2!1sen!2sus!4v1715969595882!5m2!1sen!2sus" width="100%" height="400" style="border: 0;" title="54 Joyce Kilmer Ave., Piscataway, NJ 08854" sandbox="allow-scripts allow-same-origin" allowfullscreen referrerpolicy="no-referrer-when-downgrade" loading="lazy" allow-scripts="yes"></iframe>
</p>

• For "Position," select "bottom-c".
• Click the "Menu Assignment" tab and assign the module to the "Contact Us" menu item on the Main Menu.
• Save & Close the module.

Overview

A module's position refers to its location on the web page.  A module position can usually be identified by its location outside the main content area where articles appear.  Each Joomla! template will have a different list of module positions. 

Cassiopeia module positions

Cassiopeia is the template used for SAS unit websites.  Some of the most commonly used menu positions are:

• sas-branding - The position is located in the upper left corner of the web page and contains the Rutgers Logo module (to the upper left) and the Rutgers menu (to the upper right). No other modules should be assigned to this position. 
• banner - This position is reserved for the "Main Menu" that appears below the Rutgers Logo and above the slideshow, and spans the width of the page.  No other modules should be assigned to this position. 
• sas-extension-top - This position is located directly below the main menu, and spans the width of the page.  sas-extension-top typically contains the following modules:
  • a SmartSlider slideshow or a single image with aspect ratio 3:2.
  • a red banner that appears on the homepage and the main page of microsites
  • the "Rutgers Alerts - SAS Emergency Alert Message" module
• sidebar-left - This position sits to the left of the article area. On most pages, a menu module will appear in sidebar-left.  You can have several modules in the sidebar-left position; they will stack vertically.  If there are no sidebar-left modules on a page, the article area will extend to the left side of the page.
• bottom positions - Modules in these positions appear below the article area.  There are four "bottom" positions; these positions are named (from top to bottom) bottom-A, bottom-B, bottom-C and bottom-D. You can have multiple modules in each "bottom" position; they will sit side-by-side.
• sas-extension - This position appears below the "bottom" positions.  It spans the width of the web page.  It is typically used to display a Latest News Enhanced module that has been configured to display images in three or more columns.  You can place multiple modules in "sas-extension;" they will stack vertically. 

Overview

A module in Joomla! is a "mini program" that can be displayed in various positions on the website.  Modules can make your site more dynamic and easier to work with if used properly.  You can usually identify an article by its location on the website outside the main content area where articles appear.

Types of modules

There are many different types of modules, each with different functionality.  Some modules are included with Joomla!; these are called "core modules."  Other modules come from developers outside the Joomla! Project; these are called "third-party modules."

Core modules

Some of the core Joomla! modules documented on this website include:

• Articles - Category module - displays a list of articles from a category
• Articles - Newsflash module - displays text from one or more articles
• Custom Module - displays formatted text and images, similar to an article
• Menu Module - displays a menu (or part of a menu)
• Random Image Module - displays a different image every time the page is visited

Third-party modules

Some of the third-party modules documented on this website include:

• DOCMan - Documents - displays a list of documents from the DOCman extension
• JEvents (Latest Events) - displays events from the JEvents calendar extension
• RU Courses Module - displays a listing of courses from the Rutgers Schedule of Classes

Properties

Every module has two very important properties:

1. Position
   • This determines where on the web page it will display. You can see examples of module positions here.
2. Menu Assignment
   • This determines what page(s) the module will be displayed on.  You can assign a module to one or more pages on your website.  Your module can be displayed on all pages, on a single page, or on multiple pages. 
   • A module can also be displayed on no pages, in which case you can embed it within an article.

Overview

Normally, a module is displayed in a specific module position.  It is also possible to nest (or embed) a module inside of an article.  For example, if you have a Rutgers Course List module displaying a department's list of courses, you can put the module inside of an article to display it along with other article content.

Procedure

1. Create the Module first
   • You can find documentation on creating various types of modules on this site:
     • Adding a Custom Module
     • Creating an "Articles - Category" module
     • Displaying an "Articles - Newsflash" module
     • Random Image Module
   • In the screen shots below, we are embedding an "Articles – Category" module that shows a listing of faculty articles.
2. If the module should only be displayed within an article, make the following changes to the module properties:
   
   • Leave the "Position" dropdown menu blank (see #1 below), or if a selection has been made, click the "x" to the right of the module position. 
   • Click the "Menu Assignment" tab (see #2 below)
   • 
   • Change "Module Assignment" to "No Pages"
   • 
   • Click Save & Close.
3. Create the Article
   • If the article doesn't exist yet, create it in the back end or create it in the front end.
   • If the article exists, find it in the back end and edit it, or edit it from the front end.
4. Click within the article text area to place the cursor where you want the module to appear.
5. Click the Module button below the text area.  If you see two Module buttons, click the second one (it looks like it has multiple windows in its icon):
   
6. Enter part or all of the module's title in the "Search in module title and note" field, then press [Enter] or click the search icon.  In the below example, the first arrow indicates that we're searching for a module with "web link" in its title:
   
7. In the "ID" column, click the button with the number inside it to the left of your module's title (this is the module's ID number).  In the above example, the bottom arrow indicates that we are clicking the button with the number "309," which is the ID number of the "Faculty Listing" module.
   
   Although you can also click on the module title itself, we recommend clicking the module's ID number instead. This is because the module's ID number will not change and will be unique, while your module's title may change, and two or more modules may have the same title.
8. The embedded module will not actually appear while you are still editing the article; instead, you will see the ID number of the module inside braces.
   
   
9. Save & Close the article.
10. When you view the article on the front end, the output of the module will be displayed within the article.  In this example, the article "Faculty" displays some text, then the listing of articles generated by the embedded "Articles  - Category" module:
    
    

Overview

Normally, a module is displayed in a specific module position.  It is also possible to nest (or embed) a module inside of an article.  For example, if you have a Rutgers Course List module displaying a department's list of courses, you can put the module inside of an article to display it along with other article content.

Procedure

1. Create the Module first
   • You can find documentation on creating various types of modules on this site:
     • Adding a Custom Module
     • Creating an "Articles - Category" module
     • Displaying an "Articles - Newsflash" module
     • Random Image Module
   • In the screen shots below, we are embedding an "Articles – Category" module that shows a listing of faculty articles.
2. If the module should only be displayed within an article, make the following changes to the module properties:
   
   • Leave the "Position" dropdown menu blank (see #1 below), or if a selection has been made, click the "x" to the right of the module position. 
   • Click the "Menu Assignment" tab (see #2 below)
   • 
   • Change "Module Assignment" to "No Pages"
   • 
   • Click Save & Close.
3. Create the Article
   • If the article doesn't exist yet, create it in the back end or create it in the front end.
   • If the article exists, find it in the back end and edit it, or edit it from the front end.
4. Click within the article text area to place the cursor where you want the module to appear.
5. Click the Module button below the text area.  If you see two Module buttons, click the second one (it looks like it has multiple windows in its icon):
   
6. Enter part or all of the module's title in the "Search in module title and note" field, then press [Enter] or click the search icon.  In the below example, the first arrow indicates that we're searching for a module with "web link" in its title:
   
7. In the "ID" column, click the button with the number inside it to the left of your module's title (this is the module's ID number).  In the above example, the bottom arrow indicates that we are clicking the button with the number "309," which is the ID number of the "Faculty Listing" module.
   
   Although you can also click on the module title itself, we recommend clicking the module's ID number instead. This is because the module's ID number will not change and will be unique, while your module's title may change, and two or more modules may have the same title.
8. The embedded module will not actually appear while you are still editing the article; instead, you will see the ID number of the module inside braces.
   
   
9. Save & Close the article.
10. When you view the article on the front end, the output of the module will be displayed within the article.  In this example, the article "Faculty" displays some text, then the listing of articles generated by the embedded "Articles  - Category" module:
    
    

Overview

This module will display a single image from a Media folder.  If there are multiple images in the folder, the module will display a different image each time the page is visited.  This adds variety to the site without creating a complex slideshow.

The module works best when all the images in the folder are resized and cropped to the same size.

You can assign a link to all the images displayed in the module, so that when someone clicks on the image, they will be taken to a specific page on the website.  The link will be the same for all images.

This module is not a substitute for an actual photo gallery or slide show.

Recommended uses are for study abroad pages, or for displaying different images of artwork on the home page of a website.

Procedure

Upload Images to the Media Folder

1. In the Joomla! Administrator Control Panel, select Media
   
   
2. Click Create New Folder(see #1 below).
3. Enter a name for your folder (see #2 below).  Do not use spaces, or any special characters other than a dash (-), in the name of the folder.
4. Click Create(see #3 below).
5. Select your new folder from the list of folders 
   
   
   
   
6. Upload images into the folder following the documentation: How to Add an Image to Media
   
   

Create Random Image 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 Random Image:
   
3. Enter a title for your module in the "Title:" field.
4. For "Image Folder," enter the name of the Media folder containing your images.  This should start with "images/" followed by the name of your folder.
5. If you would like the images to be linked to another page or website, enter the URL of that location in the "Link" field.
6. For "Width (px)", enter the width of the images in pixels.
7. For "Height (px)", enter the height of the images in pixels.
8. For "Position" (found to the right), select the position where the module should appear on the website. See the article "Module Position" for more information.
9. Unless the module should appear on every page of the site, assign the module to one or more menu items.
10. Click "Save & Close" to the upper left to save your new module. 

Overview

This module will display a single image from a Media folder.  If there are multiple images in the folder, the module will display a different image each time the page is visited.  This adds variety to the site without creating a complex slideshow.

The module works best when all the images in the folder are resized and cropped to the same size.

You can assign a link to all the images displayed in the module, so that when someone clicks on the image, they will be taken to a specific page on the website.  The link will be the same for all images.

This module is not a substitute for an actual photo gallery or slide show.

Recommended uses are for study abroad pages, or for displaying different images of artwork on the home page of a website.

Procedure

Upload Images to the Media Folder

1. In the Joomla! Administrator Control Panel, select Media
   
   
2. Click Create New Folder(see #1 below).
3. Enter a name for your folder (see #2 below).  Do not use spaces, or any special characters other than a dash (-), in the name of the folder.
4. Click Create(see #3 below).
5. Select your new folder from the list of folders 
   
   
   
   
6. Upload images into the folder following the documentation: How to Add an Image to Media
   
   

Create Random Image 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 Random Image:
   
3. Enter a title for your module in the "Title:" field.
4. For "Image Folder," enter the name of the Media folder containing your images.  This should start with "images/" followed by the name of your folder.
5. If you would like the images to be linked to another page or website, enter the URL of that location in the "Link" field.
6. For "Width (px)", enter the width of the images in pixels.
7. For "Height (px)", enter the height of the images in pixels.
8. For "Position" (found to the right), select the position where the module should appear on the website. See the article "Module Position" for more information.
9. Unless the module should appear on every page of the site, assign the module to one or more menu items.
10. Click "Save & Close" to the upper left to save your new module. 

Overview

The Latest News Enhanced extension can display articles using either modules or menu items.  This procedure discusses how to configure article ordering for both options.

Configuration

Module

1. Go to Extensions > Modules.
2. Click Search Tools.
3. Change "- Select Type -" to "Latest News Enhanced."
4. Click the title of the module to be configured. (If there are many Latest News Enhanced modules, changing "- Select Status -" to "Published" may help narrow down the list.
5. Click the Item Selection tab.
6. Scroll down the page and look for "Order" (see #1 below).
7. From the selection box, choose the ordering needed (see #2 below; refer to the options under Ordering Options below).
8. Save & Close the module (see #3 below).

Component (menu item)

1. Go to Menus > Main Menu.
2. Find the menu item to be configured and click on it.  This will match the title of the menu item as it appears in the horizontal "Main Menu." 
3. Click the "Item Selection" tab. 
4. Scroll to bottom of the page and look for "Order".
5. In the drop down selection box, choose the ordering needed (refer to the options under Ordering Options below).
6. Save & Close the menu item.

Ordering Options

• Console Desc: articles will appear in reverse order from their order in Content > Articles
• Console Asc: articles will appear in the same order they appear in Content > Articles
• Recently Created First: articles will be sorted based on their Created Date (newest at top)
• Recently Created Last: articles will be sorted based on their Created Date (oldest at top)
• Recently Published First: articles will be sorted based on their Start Publishing date (newest at top)
• Recently Published Last: articles will be sorted based on their Start Publishing date (oldest at top)
• Recently Modified First: articles will be sorted based on their Modified Date (newest at top)
• Recently Modified Last: articles will be sorted based on their Modified Date (oldest at top)
• Finishing Date Desc: articles will be sorted based on their Finish Publishing date (newest at top)
• Finishing Date Asc: articles will be sorted based on their Created Date (oldest at top)
• Recently Created or Modified First: articles will be sorted based on their Created Date or Modified Date, whichever comes later (newest at top)
• Recently Created or Modified Last: articles will be sorted based on their Created Date or Modified Date, whichever comes later (oldest at top)
• Random: articles will be shown in random order
• Popular (Hits): articles will be sorted based on their hits
• Title Desc: order by alphabetically by article title (descending)
• Title Asc: order by alphabetically by article title (ascending)

Overview

The Latest News Enhanced extension can display articles using either modules or menu items.  This procedure discusses how to configure article ordering for both options.

Configuration

Module

1. Go to Extensions > Site Modules.
2. Click Filter Options.
3. Change "- Select Type -" to "Latest News Enhanced."
4. Click the title of the module to be configured. (If there are many Latest News Enhanced modules, changing "- Select Status -" to "Published" may help narrow down the list.
5. Click the Item Selection tab.
6. Scroll down the page and look for "Order" (see #1 below).
7. From the selection box, choose the ordering needed (see #2 below; refer to the options under Ordering Options below).
8. Save & Close the module (see #3 below).

Component (menu item)

1. Go to Menus > Main Menu.
2. Find the menu item to be configured and click on it.  This will match the title of the menu item as it appears in the horizontal "Main Menu." 
3. Click the "Item Selection" tab. 
4. Scroll to bottom of the page and look for "Order".
5. In the drop down selection box, choose the ordering needed (refer to the options under Ordering Options below).
6. Save & Close the menu item.

Ordering Options

• Console Desc: articles will appear in reverse order from their order in Content > Articles
• Console Asc: articles will appear in the same order they appear in Content > Articles
• Recently Created First: articles will be sorted based on their Created Date (newest at top)
• Recently Created Last: articles will be sorted based on their Created Date (oldest at top)
• Recently Published First: articles will be sorted based on their Start Publishing date (newest at top)
• Recently Published Last: articles will be sorted based on their Start Publishing date (oldest at top)
• Recently Modified First: articles will be sorted based on their Modified Date (newest at top)
• Recently Modified Last: articles will be sorted based on their Modified Date (oldest at top)
• Finishing Date Desc: articles will be sorted based on their Finish Publishing date (newest at top)
• Finishing Date Asc: articles will be sorted based on their Created Date (oldest at top)
• Recently Created or Modified First: articles will be sorted based on their Created Date or Modified Date, whichever comes later (newest at top)
• Recently Created or Modified Last: articles will be sorted based on their Created Date or Modified Date, whichever comes later (oldest at top)
• Random: articles will be shown in random order
• Popular (Hits): articles will be sorted based on their hits
• Title Desc: order by alphabetically by article title (descending)
• Title Asc: order by alphabetically by article title (ascending)

Overview

These instructions explain how to upload a syllabus so that it appears as a link in the Undergraduate Course List ("RU Courses" module).

Example:

Preparation

The following steps only need to be followed once; afterwards, you can upload syllabi as needed following the steps under "Procedure" below.

• Skip to naming files.
• Skip to uploading the files.

Create Joomla! Media Manager folder

• Go to Content > Media
• If you don't see a folder called "syllabi" create it as follows:
  • Click Create New Folder
  • For the new folder name, enter "syllabi"
  • Click Create Folder

Configure RUCourses Plugin

• Go to Extensions > Plugins
• Find RUCourses Plugin and click on it
• For "Location of syllabus files" select "Joomla! - Media Manager"
• For "Select a folder" select "syllabi"
• Click Save & Close

Procedure

1) Name the syllabi files.

Use the following naming convention to rename the syllabus file to one of these formats:

YYYYsemester-school-subject-course.pdfYYYYsemester-school-subject-course-section.pdf

Replace the elements of the above format with the following: 

• YYYY:  the four digit year.
• semester:  To indicate "semester", use corresponding number below:
  • Spring: 1
  • Summer: 7 
  • Fall: 9
  • Winter: 0
• school-subject-course: standard course number
• section:  [optional]If the section is not supplied, the syllabus will be treated as a default syllabus for the course and will be loaded for any sections which do not have their own syllabus uploaded.
• file_extension:   The extension can be pdf, doc, docx, or txt.  PDF is preferred as it will retain text and layout formatting.

Example:

A syllabus for 01:377:140 (Foundations of Exercise Science and Sport Studies) Section 06, Fall 2020, PDF format would be named as follows:

20209-01-377-140-06.pdf

2) Upload the files.

Be sure to upload the documents to the "syllabi" folder on the root level of images.  If uploaded elsewhere, "RU Courses" will not be able to find them. 

1. Navigate to and upload files to the "syllabi" folder. 
   
   To find the "syllabi" folder, go to Components --> JCE Editor (or JCE Editor Pro) and click the "File Browser" icon that shows in the center of the page: 
   
   
   
2. Navigate so that you are in the "syllabi" folder.  When you are, its name will appear highlighted in the left column (see #1 below).
   
   
3. Click the cloud icon to upload files (see #2 above).  More than one file may be uploaded at a time.
   
   
4. If a file was not named properly, it can be renamed here.  To do that, click the file then look for the edit icon in the right side of window (see #3 above).