Shortlist

Sharing Lists

Lists are super simple to share. The basic options to share a list consist of the following :

http://site.url/list/{list_id}
http://site.url/list/{list_url_title}

The {list_id} will be a unique random string, and is consistent across everywhere. All lists will have one at all times, and they'll never change for a list.

The {list_url_title} is a user supplied string, set using the {exp:shortlist:edit_list_form}, and can be manually set directly by the user, or generated from the supplied title. These can be edited by the user, so can change. Across all lists the {list_url_title} will be unique.

To view a shared list, simply specify the list_id or list_url_title as a param on the {exp:shortlist:lists} or {exp:shortlist:view} tags.

More Advanced Sharing

Sometimes you might like to have a list that shares part of the url, for example, you might want to build up a sharing feature that uses the member's username, to do something like :

http://site.url/list/joesmith/kittens
http://site.url/list/maryjones/kittens

To do this, you can't simply use the {segment_3} as the {list_url_title}, as 'kittens' isn't unique, and the second list will get a value like 'kittens2'. Instead, you can use the advanced option of specifying the url title in two parts.

For this we have {list_url_title_start} and {list_url_title_end}. Together they can be used to make up a unique url title, even if parts of them overlap (in our example 'kittens').

These again, can be set using the {exp:shortlist:edit_list_form} tag.

As a bonus, you can specify either on their own on the {exp:shortlist:lists} tag, to return whole sets of matching lists easily. ie.

{exp:shortlist:lists list_url_title_start="{segment_2}"}
    {list_title}
    {segment_2}'s Lists
    {items}
        <li>&123;title}</li>
    {/items}
{/exp:shortlist:lists}

Where {segment_2} is something like 'joesmith' from our above example, this would return all the matching lists where 'list_url_title_start' matches 'joesmith'. Great for when you need to show all of a set of lists in a single tag.