Note on Features: Some features documented here require an addon, refer to the Feature List for details.

Note about 'Listings': The use of the term "listings" in the user manual can refer to classifieds, classified ads, standard auctions, dutch auctions, reverse auctions, and buy now only.

Recent Changes[unknown link type]

Differences

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

Link to this comparison view

startup_tutorial_and_checklist:feature_configuration:module_configuration:customize_module_display [2015/04/16 14:57] (current)
geojames created
Line 1: Line 1:
 +====== Customize Module Display ======
  
 +Customization of module can be quite extensive and very detailed if you like.  We supply the following "​browsing views" any module can be displayed in:
 +
 +  /​geo_templates/​[your template set - not default]/​system/​browsing/​common/​gallery_view.tpl
 +  /​geo_templates/​[your template set - not default]/​system/​browsing/​common/​grid_view.tpl
 +  /​geo_templates/​[your template set - not default]/​system/​browsing/​common/​list_view.tpl
 +
 +The above system templates are common to all modules. ​ So if a module is set to display in list view and you make changes to the above list view template those changes will affect all modules using the same list view to display their listings.  ​
 +
 +Most of the fields that can be displayed within the module using the "​module display controls"​ found in the LISTING SETUP > FIELDS TO USE admin tool.  But there is data beyond that which can be displayed in the module if you are willing to dig into the html/smarty code of a module. ​ Just about any "​listing specific"​ data that can be displayed within the listing details page for any listing can be displayed within the browsing view of any module. ​ And if you dig into the details of the template you can create a display for a module that is unique and highly custom in it's display of the listing data. 
 +
 +So if you wish to move forward with a customization of one of the above templates to get a very custom display you'll need to follow the steps in the [[startup_tutorial_and_checklist:​design_configuration:​design_tools:​system_template_changes:​system_module_changes|customizing system/​module templates wiki page]] to get those templates into your custom template set.
 +
 +Once you have that template copied over you can open it and see how listing data is placed. ​ Below is a snippet from the {debug} tag output when we placed it in one of the above templates. ​ In it you'll see all the data that can be placed. ​ To place any of them within one of the templates above you would use a tag similar to:
 +
 +  {$listing.xxxxxx}
 +  ​
 +where "​xxxxxx"​ is the label of that field to be placed. ​ So following the data display below:
 +
 +  {$listing.id} would display the listing'​s id
 +  {$listing.title} would display the listing'​s title
 +  {$listing.seller_username} would display the listing'​s seller'​s username
 +  ​
 +And many more....While the "first level" data may not change the data fields with "​mulitply layers"​ like the layered (multi-level fields) will require some more changes and could be a different structure per multi-level field and it's configuration. ​ The full list of fields is below but note this was from a specific listing in our test installation and as stated your's could be a bit different considering configuration:​
 +
 +<​code>​
 +    id => "​90"​
 +    seller => "​80"​
 +    live => "​1"​
 +    title => "test listing title"
 +    date => "​1426706086"​
 +    description => "​test"​
 +    language_id => "​1"​
 +    precurrency => "​$"​
 +    price => "$0.01 USD"
 +    postcurrency => "​USD"​
 +    conversion_rate => "​1"​
 +    price_applies => "​lot"​
 +    image => "​geo_templates/​my_templates_7_4_1/​exte..."​
 +    offsite_videos_purchased => "​0"​
 +    additional_regions_purchased => "​0"​
 +    category => null
 +    duration => "​365"​
 +    location_city => "​testing19"​
 +    location_zip => "​testing19"​
 +    ends => "​1458242086"​
 +    search_text => "​test+-+"​
 +    viewed => "​0"​
 +    responded => "​0"​
 +    forwarded => "​0"​
 +    bolding => "​0"​
 +    better_placement => "​0"​
 +    featured_ad => "​0"​
 +    featured_ad_2 => "​0"​
 +    featured_ad_3 => "​0"​
 +    featured_ad_4 => "​0"​
 +    featured_ad_5 => "​0"​
 +    attention_getter => "​0"​
 +    attention_getter_url => ""​
 +    expiration_notice => "​0"​
 +    expiration_last_sent => "​0"​
 +    sold_displayed => "​0"​
 +    business_type => "​ind"​
 +    optional_field_1 => "​test"​
 +    optional_field_2 => "​2342424"​
 +    optional_field_3 => ""​
 +    optional_field_4 => ""​
 +    optional_field_5 => ""​
 +    optional_field_6 => ""​
 +    optional_field_7 => ""​
 +    optional_field_8 => ""​
 +    optional_field_9 => ""​
 +    optional_field_10 => "​test"​
 +    one_votes => "​0"​
 +    two_votes => "​0"​
 +    three_votes => "​0"​
 +    vote_total => "​0"​
 +    email => "​testing19%40geodesicsolutions.com"​
 +    expose_email => "​0"​
 +    phone => "​testing19"​
 +    phone2 => "​testing19"​
 +    fax => "​testing19"​
 +    filter_id => "​0"​
 +    mapping_location => "1600 Pennsylvania Ave NW, Washington,​..."​
 +    paypal_id => ""​
 +    renewal_length => "​0"​
 +    optional_field_11 => "​test"​
 +    optional_field_12 => "​tes"​
 +    optional_field_13 => ""​
 +    optional_field_14 => ""​
 +    optional_field_15 => ""​
 +    optional_field_16 => ""​
 +    optional_field_17 => ""​
 +    optional_field_18 => ""​
 +    optional_field_19 => ""​
 +    optional_field_20 => "​freeeeeeeeeee"​
 +    discount_id => "​0"​
 +    discount_amount => "​0.00"​
 +    discount_percentage => "​0.00"​
 +    url_link_1 => ""​
 +    url_link_2 => ""​
 +    url_link_3 => ""​
 +    price_plan_id => "​5"​
 +    auction_type => "​1"​
 +    quantity => "​1"​
 +    quantity_remaining => "​1"​
 +    final_fee => "​1"​
 +    minimum_bid => "$0.01 USD"
 +    starting_bid => "$0.01 USD"
 +    reserve_price => "​0.00"​
 +    buy_now => "​0.00"​
 +    current_bid => "​freeeeeeeeeee"​
 +    final_price => "​0.00"​
 +    high_bidder => "​0"​
 +    start_time => "​0"​
 +    payment_options => ""​
 +    end_time => "​0"​
 +    buy_now_only => "​0"​
 +    item_type => "​2"​
 +    storefront_category => "​18"​
 +    hide => "​0"​
 +    reason_ad_ended => ""​
 +    location_address => "​testing19+testing19"​
 +    order_item_id => "​541"​
 +    delayed_start => "​0"​
 +    show_contact_seller => "​yes"​
 +    show_other_ads => "​yes"​
 +    charge_per_word_count => "​0"​
 +    seller_buyer_data => null
 +    upgrade_category_id => "​0"​
 +    regionInfo => Array (2)
 +      maxDepth => 0
 +      enabledLevels => Array (0)
 +    classified_id => "​90"​
 +    viewed_count => "​0"​
 +    seller_id => 80
 +    seller_username => "​testing19"​
 +    seller_first_name => "​testing19"​
 +    seller_last_name => "​testing19"​
 +    seller_url => "<a href="​http://​testing19"​ rel="​nofol..."​
 +    seller_address => "​testing19 testing19"​
 +    seller_city => "​testing19"​
 +    seller_state => ""​
 +    seller_country => "​United States"​
 +    seller_zip => "​testing19"​
 +    seller_phone => "​testing19"​
 +    seller_phone2 => "​testing19"​
 +    seller_fax => "​testing19"​
 +    seller_company_name => "​testing19"​
 +    seller_optional_1 => ""​
 +    seller_optional_2 => ""​
 +    seller_optional_3 => ""​
 +    seller_optional_4 => ""​
 +    seller_optional_5 => ""​
 +    seller_optional_6 => ""​
 +    seller_optional_7 => ""​
 +    seller_optional_8 => ""​
 +    seller_optional_9 => ""​
 +    seller_optional_10 => "​testing19"​
 +    member_since => "Mar 18, 2015"
 +    date_started => "18 Mar 2015, 20:14"
 +    address_data => "​Testing19 Testing19"​
 +    city_data => "​Testing19"​
 +    state_data => "​Alabama"​
 +    country_data => "​United States"​
 +    zip_data => "​testing19"​
 +    phone_data => "​testing19"​
 +    phone2_data => "​testing19"​
 +    fax_data => "​testing19"​
 +    auction_type_data => null
 +    type => "<​img src="​geo_templates/​my_templates_..."​
 +    full_image_tag => false
 +    icons => Array (8)
 +      sold => false
 +      buy_now => false
 +      reserve_met => false
 +      reserve_not_met => false
 +      no_reserve => true
 +      attention_getter => false
 +      verified => false
 +      addon_icons => Array (0)
 +    tags => Array (1)
 +      0 => "​test"​
 +    location_breadcrumb => "<​span class="​listing_region_breadcrum..."​
 +    address => "​testing19 testing19"​
 +    city => "​testing19"​
 +    state => "​Alabama"​
 +    country => "​United States"​
 +    zip => "​testing19"​
 +    optionals => Array (20)
 +      1 => "​test"​
 +      2 => "​2342424"​
 +      3 => ""​
 +      4 => ""​
 +      5 => ""​
 +      6 => ""​
 +      7 => ""​
 +      8 => ""​
 +      9 => ""​
 +      10 => "​test"​
 +      11 => "​test"​
 +      12 => "​tes"​
 +      13 => ""​
 +      14 => ""​
 +      15 => ""​
 +      16 => ""​
 +      17 => ""​
 +      18 => ""​
 +      19 => ""​
 +      20 => "​freeeeeeeeeee"​
 +    num_bids => 0
 +    entry_date => false
 +    time_left => "48 weeks, 0 days"
 +    leveled => Array (1)
 +      14 => Array (4)
 +        1 => Array (9)
 +          id => "​74986"​
 +          leveled_field => "​14"​
 +          parent => "​0"​
 +          level => "​1"​
 +          enabled => "​yes"​
 +          display_order => "​49"​
 +          language_id => "​3"​
 +          name => "​1984"​
 +          level_info => Array (6)
 +            level => "​1"​
 +            leveled_field => "​14"​
 +            always_show => "​no"​
 +            labels => Array (2)
 +              1 => "​Year"​
 +              3 => "​Year"​
 +            label => "​Year"​
 +            sample => ""​
 +        2 => Array (9)
 +          id => "​75078"​
 +          leveled_field => "​14"​
 +          parent => "​74986"​
 +          level => "​2"​
 +          enabled => "​yes"​
 +          display_order => "​11"​
 +          language_id => "​3"​
 +          name => "​Bmw"​
 +          level_info => Array (6)
 +            level => "​2"​
 +            leveled_field => "​14"​
 +            always_show => "​yes"​
 +            labels => Array (2)
 +              1 => "​Make"​
 +              3 => "​Make"​
 +            label => "​Make"​
 +            sample => ""​
 +        3 => Array (9)
 +          id => "​75082"​
 +          leveled_field => "​14"​
 +          parent => "​75078"​
 +          level => "​3"​
 +          enabled => "​yes"​
 +          display_order => "​2"​
 +          language_id => "​3"​
 +          name => "​318"​
 +          level_info => Array (6)
 +            level => "​3"​
 +            leveled_field => "​14"​
 +            always_show => "​yes"​
 +            labels => Array (2)
 +              1 => "​Model"​
 +              3 => "​Model"​
 +            label => "​Model"​
 +            sample => ""​
 +        4 => Array (9)
 +          id => "​75083"​
 +          leveled_field => "​14"​
 +          parent => "​75082"​
 +          level => "​4"​
 +          enabled => "​yes"​
 +          display_order => "​1"​
 +          language_id => "​3"​
 +          name => "​i"​
 +          level_info => Array (6)
 +            level => "​4"​
 +            leveled_field => "​14"​
 +            always_show => "​yes"​
 +            labels => Array (2)
 +              1 => "​Trim"​
 +              3 => "​Trim"​
 +            label => "​Trim"​
 +            sample => ""​
 +    edit => "​edit"​
 +    delete => "​delete"​
 +    css => "​browsing_result_table_body_even"​
 +    addonData => Array (0)
 +</​code>​
/home/geodesicsolutionscom/apps/dokuwiki/data/pages/startup_tutorial_and_checklist/feature_configuration/module_configuration/customize_module_display.txt · Last modified: 2015/04/16 14:57 by geojames
CC Attribution-Noncommercial-Share Alike 4.0 International
www.chimeric.de Valid CSS Driven by DokuWiki do yourself a favour and use a real browser - get firefox!! Recent changes RSS feed Valid XHTML 1.0