View Module:Selected Items

Introduction

The Selected Items module/extension allows you to create ordered lists of weblog entries.

Each selection can be arbitrarily ordered or ranked, and entries can exist in more than one selection (in different orders).

Installation

  1. Copy the contents of the extension folder to system/extensions
  2. Copy the contents of the language folder to system/languages/english
  3. Copy the selecteditems folder in the module folder to system/modules

In the Control Panel:

  1. Install the extension from the Extension manager
  2. Install the module

Usage

In the Selected Items module, click on Create new selection in the top right hand corner.

Give the selection a name, description, and add some entries to the Selected list.

The list of available weblog entries can be filtered using the form on the left hand side. Optionally select a search term, weblog and click on Get entries to update the list. Click on Add -> to add selected entries to the right hand selection list.

Selected items can be removed, or reordered using the Move up/Move down buttons.

A selected list can contain a mixture of entries from different weblogs.

Click on the Create new selection button to save.

Template

Wrap the {exp:selecteditems} tag around a {exp:weblog:entries} tag.

The name= parameter should corresond to the name of a selection created in the module’s Control Panel.

The {exp:weblog:entries} tags should have the following parameters:

entry_id="{selecteditems_id}" orderby="selecteditems”

and should not have a limit (this is imposed by the module).

Example

{exp:selecteditems name="test_sequence"}

{exp:weblog:entries weblog="default_site|news" entry_id="{selecteditems_id}" 
    orderby="selecteditems" disable="member_data|trackbacks"}

<h2 class="{selecteditems_switch="one|two|three"}">{selecteditems_count}: {entry_id} - {title}</h2>

{/exp:weblog:entries}

{/exp:selecteditems}

Parameters

Just the one, name, which is the name of the selected list.

Variables

These replace the standard exp:weblog:entries variables