Table of Contents
The listings module is used to store an arbitrary list of data. You can have any number of listing types and any number of listings of each type.
You can add a large number of listings at a time using either the importer or the bulk-adder. If you upload a CSV file with the importer, you will then be shown the bulk-add form populated by the CSV data.
To use the importer, click on the link from the Setup tab in the Listings module. You will then be prompted to upload a CSV file and select the type of listings you're importing.
The first row of the CSV file must contain the headings of which fields to map to. These headings should correspond to the names of the custom fields for the event type you're importing. Additionally, the following field titles are mapped to the event:
Title
Files
Categories
Next you will be shown the listings found in your CSV file, where you will be able to make any changes as required, as well as seeing any errors that occurred.
You can link imported listings to categories by specifying a column called
Categories. Each listing can be linked to multiple categories,
each of which should appear on a new line within the listing.
Categories are specified by separated the category path using a slash. For example,
if your main categories is Australia and sub-category is
South Australia, the full category path is
/Australia/South Australia.
You can link imported listings to files in the File Manager by specifying a column
called Files. Each listing can be linked to multiple files, each of
which should appear on a new line within the listing.
Files are specified using their full path in the File Manager.
Don't prefix the path with /assets as you would on the
client web site.
When viewing the matrix of import data, you can choose how duplicate rows should be handled. If a row is deemed to be a duplicate, you can choose to create a new listing (in addition to the original); you can update the original with new data; or you can flag the row as an error.
In order to detect duplicates you must choose which field determines whether a row is a duplicate or not.
Additionally, you can choose the scheme for updating categories and files. You can either replace current categories or files with those specified in the new CSV, or you can merge them.