Documentation

Features

Differences

This shows you the differences between the selected revision and the current version of the page.

administration:extrafields 2008/08/25 04:33 administration:extrafields 2011/03/06 14:40 current
Line 1: Line 1:
====== Extra Fields ====== ====== Extra Fields ======
-The 'Extra Fields' area is where you can define extra fields that users enter when placing a listing.+===== Overview ==== 
 +By default, all listings have the following main fields that show when a listing is shown: 
 +  * Title 
 +  * Price 
 +  * Date Added 
 +  * Expiration Date 
 +  * Description 
 +  * URL 
 +(Note: There are some other fields that each listing contains as well, but are not relevent to this topic)
-===== Drop-Down List Or Checkbox List =====+Extra Fields allow the site owner (administration) to add additional fields to their sellers listings, beyond the standard main fields. These extra fields have several different options to give you complete control over the use and availability of them to the sellers. The most important aspect and option of an extra field is the ability to select which category(ies) that you wish to allow access of the field. 
 + 
 +As an example: if you have a "Houses for Sale" category and a "Land for Sale" category, you could create extra fields named "Acreage", "Bedrooms" and "Bathrooms". You could then assign the "Acreage" extra field to both the "Houses for Sale" and the "Land for Sale" categories. The "Bedrooms" and the "Bathrooms" extra fields could be assigned only to the "Houses for Sale" category. 
 + 
 +Now when a seller chooses to place an ad in the "Houses for Sale" category, in addition to all of the standard fields, they would also have the "Acreage", "Bedrooms" and "Bathrooms" extra fields as well, but a listing in the "Land for Sale" category would only have the one extra field, "Acreage" available. All other categories would just have the standard listing fields. 
 + 
 +===== Create (or modify) An Extra Field ==== 
 +To create or modify extra fields, login as an administrator to your site. Select the "Categories" main tab, then select the "Extra Fields" from the sub menu. There are no extra fields created with a default installation, so nothing will show in the table list of extra fields until you have created and saved one or more extra fields. 
 + 
 +To create a new extra field, you need to click on one of the four types of extra fields shown under the Extra Fields table list. Your options are: 
 +  * New fields 
 +    * New Option (For a Drop-Down List or a Checkbox List) 
 +    * New Text Option (For a Text Single Line, Text Multi Line, File Upload or a Date Field) 
 +  * Advanced Parent or Child fields 
 +    * Parent Drop-Down List 
 +    * Child Drop-Down List 
 + 
 +Select one of these and then just fill out the form which may be different depending upon the type of field that you selected. Continue reading for more in-depth explainations for each type of field. 
 + 
 +===== Drop-Down List Or Checkbox List (New Option) =====
This section covers instructions for creating a new drop-down list or check-box list. This section covers instructions for creating a new drop-down list or check-box list.
Line 36: Line 63:
  = Please select which categories use this field : When you create a field, you may want to associate the field with a few of your categories. Select which categories this field will be assigned to here. Hold down your "Ctrl" key to select multiple categories.   = Please select which categories use this field : When you create a field, you may want to associate the field with a few of your categories. Select which categories this field will be assigned to here. Hold down your "Ctrl" key to select multiple categories.
 +
 +<html>
 +<!--
 +===== How to allow your customers to add video to a listing =====
 +
 +It's possible for your customers to add a video to their listing by using the Extra Field system. The first step in allowing customers to add video to their listings is to create an Extra Field as outlined elsewhere on the page.
 +
 +It would probably be best to create a 'multi-line text field' so that the entire "embed" code from a video hosting site (like YouTube and Vimeo) can be seen by the customer when it's pasted to the field.
 +
 +The next step is to make sure that you include the html tags used in the "embed" code in the "Allowed Tags" field within administration. This is done by:
 +  * logging into administration
 +  * navigate to "Settings >> Settings >> Checkout Settings"
 +  * at the bottom of the page, add the html tags you want to allow. For example, YouTube's embed code uses: object, param and embed tags.
 +
 +Once you have successfully created the extra field and added the allowed tags, your customers will be able to paste the "embed" code from a video hosting site.
 +-->
 +</html>
===== Advanced Parent/Child Select List ===== ===== Advanced Parent/Child Select List =====
Line 46: Line 90:
In this example we will be using cars with a make model choice, but again this can be changed to whatever suits your site. In this example we will be using cars with a make model choice, but again this can be changed to whatever suits your site.
-  1. We recommend creating the child fields first that way you only have to add/edit the parent one time. So create a new child option named Ford Model and enter all the Ford models. Then save and you will be returned to the main extra fields page. +  - We recommend creating the child fields first that way you only have to add/edit the parent one time. So create a new child option named Ford Model and enter all the Ford models. Then save and you will be returned to the main extra fields page. 
-   2. Now create another child option named Toyota Model and enter the Toyota models then click submit. + - Now create another child option named Toyota Model and enter the Toyota models then click submit. 
-   3. After you hit submit you will again be returned to the main extra fields page with a list of all the extra fields. + - After you hit submit you will again be returned to the main extra fields page with a list of all the extra fields. 
-   4. From this screen get the id number of the two fields you just created. We will say these are number 1 and 2 respectively. + - From this screen get the id number of the two fields you just created. We will say these are number 1 and 2 respectively. 
-   5. Now create a new parent option named Make and enter Ford and Toyota as the options. Beside each one of these you will see an input field which is where you would enter the child id from the previous screen. So in our case we would enter Ford 1 and Toyota 2. + - Now create a new parent option named Make and enter Ford and Toyota as the options. Beside each one of these you will see an input field which is where you would enter the child id from the previous screen. So in our case we would enter Ford 1 and Toyota 2. 
-   6. Please keep in mind that a parent option must relate to a child and can not relate to another parent. It will only go one level deep.+ - Please keep in mind that a parent option must relate to a child and can not relate to another parent. It will only go one level deep.
 +<html>
 +<embed src="http://blip.tv/play/AebgUgA" type="application/x-shockwave-flash" width="640" height="510" allowscriptaccess="always" allowfullscreen="true"></embed>
 +</html>
 + \\
 +
 +----
 + \\
 +This page has been audited and certified by [[http://Mike-N-Tosh.com/blog/|Mike-N-Tosh™]] for accuracy per 68 Classifieds standards.

Have more questions? Visit our community forums.