Differences

This shows you the differences between two versions of the page.

--- addons:bulk_uploader:format_tips [2014/10/01 16:30]
geojames
+++ addons:bulk_uploader:format_tips [2015/10/28 22:01] (current)
geomatt
@@ Line 2: / Line 2: @@
 Certain fields in the Bulk Upload process require their data to be entered in specific ways that are not always immediately obvious. This page should help to document those:
+====="List" Keyword=====
+When the word "List" is used in a column name in the bulk uploader (as in "Images List" or "Locations (Terminal Regions) [List]"), it indicates that field accepts a comma-delimited list of multiple values. Note that item order within a **List** field is preserved (e.g. the ultimate Display Order of images added via **Image List** will match the order in which they appear in the **List**)
 =====Price=====
@@ Line 31: / Line 35: @@
 You only need to include "Impala" within the  csv data and assign that field to the multi-level field.  If for instance you happen to include make in one column and model in another column of your csv data just assign the column that contains the model to the multi-level field in the bulk upload configuration and the software will assign "Impala" at the "model level" and auto assign "Chrevrolet" at the make level.
+=====Youtube Video List=====
-=====Images=====
+See the notes on the **List** keyword above. Data to this field may be in any format supported by the front-end video uploader. E.g., both "http://www.youtube.com/watch?v=dQw4w9WgXcQ" or simply "dQw4w9WgXcQ" are acceptable inputs.
-====Image List====
-This is a comma-delimited list of all the image URLs to use for each listing. This functions the same as using each of the "Image URL #" columns, but combines them into one column. For example, this column's data for a given listing might read:
-"http://example.com/images/mypic1.jpg,http://example.com/images/mypic2.jpg,http://example.com/images/mypic3.jpg"
-You can further shorten the required data by using one of the "Base Image Path" settings (see below).
-====Youtube Video List====
-This works exactly like the Image List, but for videos. The data may be in any format supported by the front-end video uploader. E.g., either "http://www.youtube.com/watch?v=dQw4w9WgXcQ" or simply "dQw4w9WgXcQ"
-====Base Image Path (Step 1) vs. Base Image URL (Step 2)====
-You can specify a "base" path to your images in one of two locations. **DO NOT USE THEM BOTH.** Those places are either the "Base Image Path" setting on Step 1 of the upload process, or by setting a column of the upload data to be the "Base Image URL" on Step 2. The Step 1 path setting applies to EVERY listing in the source file, while the Step 2 base url setting may be different for each listing. Here are some examples of ways the two settings can both be useful:
-<tip c h>
-  * Base Image Path (Step 1): "http://example.com/images/"
-  * Listing 1 "Base Image URL": **NONE!**
-  * Listing 1 "Image List:" "mypic1.jpg,mypic2.jpg,mypic3.jpg"
-  * Listing 2 "Base Image URL": **NONE!**
-  * Listing 2 "Image List:" "mypic4.jpg,mypic5.jpg,mypic6.jpg"
-</tip>
+=====Locations (Terminal Regions) [List]=====
-<tip c h>
+You may use the bulk uploader to specify regions for each listing, for use with the Geographic Navigation addon. To do so, specify the lowest-level region for each listing. You can specify either the Region ID number (shown next to each region in the Geographic Setup > Regions page) or the name of the region in text form. If your site has multiple regions with identical names, it is recommended to use ID numbers instead of names, to ensure exactly the correct regions are used.
-  * Base Image Path (Step 1): **NONE!**
-  * Listing 1 "Base Image URL": "http://example.com/images/"
-  * Listing 1 "Image List:" "mypic1.jpg,mypic2.jpg,mypic3.jpg"
-  * Listing 2 "Base Image URL": "http://example.net/media/pictures/"
-  * Listing 2 "Image List:" "yourpic24.jpg,yourpic67.jpg,yourpic48.jpg"
-</tip>
+This can be used to set a primary Region, as well as Additional Regions, and will preserve the order of entered data. For example, given the data point "Dallas, Forth Worth, Waco" the listing's primary Region will be Dallas, while it will have Fort Worth and Waco as Additional Regions.
-====Valid Image Paths====
+=====Category-Specific Checkbox List=====
-The surest way to bulk upload an image is to give the uploader its fully-qualified, public URL (e.g. "http://example.com/images/mypic1.jpg"). If the image is already uploaded to the local server **AND** you are using the "Better Quality" (not "Faster") image upload method, you also have the option to specify the local path instead (e.g. "/var/www/html/images/mypic1.jpg")
+The "Checkbox List" will appear as an option during Step 2, in the Category Questions dropdown.
+This is a quick way to set multiple "checkboxes" in a listing to true. You will need to know the internal ID number of each checkbox you want to set. This number appears in (parenthesis) after the Name of each question on the Category Questions admin page.
-=====Geographic Location=====
+The Checkbox List accepts a comma-separated list of questions that should be marked as on. For example, if you're using the default questions packaged with the Automobiles category, and you want to upload a car that has GPS, OnStar Technology, and Air Conditioning, you could enter "152,153,166" in the Checkbox List field.
-You may use the bulk uploader to specify a geographic region for each listing. To do so, specify the lowest-level region for each listing. You can specify either the Region ID number (shown next to each region in the Geographic Setup > Regions page) or the name of the region in text form. If your site has multiple regions with identical names, it is recommended to use ID numbers instead of names, to ensure exactly the correct regions are used.
 =====Storefront Category ID#=====

Geodesic Solutions Community Wiki

User Tools

Site Tools

Differences

Page Tools