soPrograms (older version 1)
Tag Name
Description
Shows a list of audio/video/image programs on the page (also called a Media Archive). To manage the contents of the media archive, however, you will use the Media Archives tool in SiteOrganic.
NOTE: This tag is deprecated with the release of SiteOrganic Media Suite 2 in August 2010. Please use soProgramLanding instead.
Required Parameters
none
Optional Parameters
- groupID (integer; leave this blank to show all programs for the organization)
- seriesID (integer; leave this blank to show all series)
- showFuture (true/false; controls whether or not programs with their dates in the future will appear on the Website. If set to false, then programs will not appear until their date has elapsed)
- showDetails (true/false; controls whether or not programs inside a series will be shown automatically. If set to false, then the viewer will need to click a "Show Details" link to expand each series).
- startDate (date of first day in date range; leave this and endDate blank to show all programs. Format should be MM/DD/YYYY)
- endDate (date of last day in date range; leave this and startDate blank to showall programs. Format should be MM/DD/YYYY)
- seriesUseDate (start/end; controls the sorting order of series on your media page. If set to 'start'--which is the default--then your series will be considered to have the date of whatever program is the oldest inside that series. If you set this to 'end', then the series will always carry the date of its newest program).
- seriesSort: ("alpha" will show series-level items alphabetically. If you don't specify this parameter, then the default behavior is to show series in reverse-chrotnological order)
- programsSort: ("alpha" will show your programs alphabetically within a series. "desc" will show them in reverse chronological order. If you don't specify this paramater, then programs will be shown in chronological order (oldest on top) within each series)
NOTE: To determine the ID number for a group, go to Edit Site > Edit Pages. You will see the group ID number listed next to each Group.
Example
In the above example, the media archives from group #123 will be shown on the page. Programs with future dates will not be shown until their dates elapse. Each series will be placed on the list based on the most recent program it contains.