Please note that Mixed Content Lists are for use on r5 (responsive) sites only. This module type does not function on classic sites.
Mixed content lists allow you to create a predefined list of content to display on a page. This module is meant to replace both Article List modules and Gallery List modules. Mixed content lists have the same essential functionality as article lists and gallery lists, but allow for a greater degree of flexibility in both types of content to display and in the styling of the list on your site.
Mixed content lists can be created under the Content Manager section of Rivista. Click "New Content Module" and select "Mixed Content List."
Here are explanations of the various fields available in this module:
- Title - This field is only used internally, within your Rivista interface. Name your module in whatever fashion works best to describe the function of your module.
- Category - Not required. Content Manager modules can belong to categories. To include this module in an existing or new category, simply type the name of the category. If the category already exists, you will see a prompt to include this module in that category. If you type a name that does not exist, a new category will be created automatically for you. Categories can be used to sort and filter your Content Manager browser, as well as the "Add and Arrange Modules" interface on the Page Editor.
- ID Name - This field is used to apply an internal named ID that can be referenced in your templates.
- Published - This toggle controls whether the module is published on your live site. Unpublished modules will not appear as available for placement in the left field of the "Add and Arrange Modules" interface.
- Notes - This field is for any notes you may want to leave for yourself or other people working on your website.
- HTML ID - Not required. Use this field to set a unique ID for your module that will show up in the rendered markup. The ID value must start with a letter, and may not include a space. Legal characters include: a through z, A through Z, 0 through 9, underscore, and dash. This field is automatically filled in once you save your module with that module's HTML ID.
- HTML Class Name(s) - Not required. Use this field to set a CSS class or classes for your module that will show up in the rendered markup. Each class value must start with a letter. Multiple class names can be specified by separating them with spaces. Legal characters include: a through z, A through Z, 0 through 9, underscore, and dash.
- Template - You must select a template for your content list. The template controls the layout of your module.
module.contentitemlist.basic.tpl - Shows a basic, vertical list of content, based on the tags selected within the module. This is the same basic layout as the "module.articlelist.basic.tpl" available for article lists.
module.contentitemlist.grid.tpl - This template displays content in a grid. If you chose this option, an additional field will appear towards the bottom of the settings - "Override Grid Auto-Width?" This field allows you to dictate how many items appear in each row of the grid. Set the number of items per row for different breakpoints. For example, you could have a 12 items in the list, and set 3 items per row for larger devices, changing the number as the device size lessens. You may need to adjust these settings after viewing your module on your site and on different devices. The following will show 4 rows of 3 items per row on large devices, 6 rows of 2 items on intermediate devices, and 12 rows of 1 item on small devices:
- List Title - This field is the name of your module, as it will appear on your website.
- Content Selection Type - Selecting how you want the module to find content. The default option is "Selected Tags" meaning the module will use the tags checked off in the "Select Tags" section. The "Related Content" option is used when created related content modules, and "Archive" is for article archive modules. These options are generally not used, as such modules should already exist on your site.
- Select Tags - Use this checkbox list to select the tags you wish to use to determine what content items to include in your list. This applies to all content items. This is the same as on article lists.
- Content Matches - This allows you to tell the module to use all selected tags or any selected tags. If you want the module to show only content with BOTH "Featured" and "Dining" tags, you would chose "All Selected Tags." If you'd like it to show articles tagged with "Featured" OR "Dining" chose "Any Selected Tag." This is the same functionality as the "Operator (And/Or)" on article lists.
- Content Types - You may select one or more content types to be displayed in your module. Any piece of content - whether it be an article, gallery, link, page, or custom data listing - must be tagged in order to show here.
Note: Links can be managed in the "Links" section of Rivista. This section allows you to add external links and put them in a traditional list form. You may add thumbnails, subtitles, summaries, etc. to links, just like other pieces of content.
- Article Issue Filter - This option allows you to control whether or not the articles in the list should be limited to the current issue, or all issues in the system.
- Article Publication Filter - This option allows you to control whether the articles in the list should be limited to the host publication (the publication of the page that the content list is on) or all publications. Generally, this should be set to "All" as the tagging structure will limit the articles that appear. If you have many different publications in your Rivista, you may want to consider using "Host."
- Show thumbnails? - This option controls whether or not to show a thumbnail with each content item in the list. Thumbnails are derived from the image uploaded with the content. Articles will use the main article teaser image. Links, pages, and custom data will use the teaser image that can be uploaded. Galleries will use the thumbnail uploaded to the gallery. Note that if you use galleries, only the thumbnail of each gallery will show on the list - not all of the images within one gallery.
- Aspect Ratio - Use this to set the ratio for your images. Use landscape for wider images and portrait for taller images.
- Image Width - Here you can set the image width. Use a percentage. if you are using the basic template, set the width to 30% and adjust from there. If you are using the grid template, set the width to 100%.
- Minimum Image Width (optional) - This allows you to set a minimum width in pixels and ensures that thumbnail images are never smaller than that width.
- Image Quality - This can be an integer between 1 and 100. Higher numbers may cause sites to take longer to load. A general guideline is to set this to 85 and adjust from there.
- Image Position - If your module is using the basic template, you can set whether the image will appear on the left hand side or the right hand side.
- Gallery Page - You only need to set this if you've selected "Galleries" as a content type. This is the gallery page that your module will connect to. All galleries are dynamically generated using one gallery page.
Note: If you don't have a gallery page (nothing shows in the dropdown), you will need to create one. Make a new page, title of your choice. Use the fullwidth.tpl template, make sure the page is published, and move the "Gallery Display" module into the center. Once this page is created, it will appear in the dropdown (you may need to update the module to see it).
- Number of items in the list - This value must be an integer, and controls the number of items to show in the list.
- Sort Order - Options for controlling how the content items are sorted.
- Show Item Tags? - This option allows the tags to be displayed for each item in the content list.
- Show Subtitles? - This controls whether or not to display the subtitle field found in the teaser section for each item on the list.
- Show article by-lines? - This controls whether or not to display the byline field found in the teaser section for each item on the list.
- Show article summaries? - This controls whether or not to display the summary field found in the teaser section for each item on the list.
- Show a link to the archive? - This controls whether or not to display a link to the Archive page. The Content List Archive page must exist, be published, and be defined in the Publication Settings first, or this option will create a link that does not work. If you need assistance with the archive page set up, contact firstname.lastname@example.org
- Archive link text - This field can be used to override the default "Archive >>" text that appears as the link to the archive. You can enter any text you want in this field, though the most common is "More >>".
- Archive list title - Controls the title on the archive page the user goes to when they click on the archive link. The default title is "Archive of (Tag Name)." You may override that with this field - for example, you could set this to be "Dining Features" instead. Note that ampersands (&) do not work in this field and will not render your title properly. You may use plus signs (+) or "and" instead.
- Show Published Date? - Chose whether or not to show the date the content item was published on the module. This is turned on for the grid list on http://wireframe.godengo.net/r5/Content-Lists/?previewmode=on
- Date Published Format - This allows you to change the default date format. This field only accepts Smarty code (http://www.smarty.net/docsv2/en/language.modifier.date.format). Contact email@example.com if you need help with this.
- Show Share Buttons? - This displays various share buttons on each item in the content list.
- Infinite Scrolling List? - Infinite scrolling offers an alternative to pagination. This option continues to load content as the user scrolls down the page. This option is most often used on archive modules, which have a large number of content items.
This section allows you to insert other modules in between items on the content list. This is most often used to insert an ad after a certain number of articles in a content list.
- Insert Modules in List - This dropdown is the number of content items that appear before your inserted modules. If you set this to 8, the inserted module will appear after the 8th item, the 16th item, the 24th item, etc., depending on how many items your list is set to show.
- Modules to Insert - Here you can chose which module to insert. Again, this is generally used to insert ads. You may use more than one.
After you have configured the module by providing input to the fields displayed, you may add it to pages. To do this, go to the Page Editor, Add/Arrange Modules and add the newly created module to your page.