Web Development Documentation

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: