Difference between revisions of "How do I link to my website?"

From Catalyst
Jump to: navigation, search
(Can I show vehicles matching a search?)
(Bulk update)
 
(25 intermediate revisions by 8 users not shown)
Line 1: Line 1:
 
== Summary ==
 
== Summary ==
You can link to your FindIt vehicle advertising website or Platinum O+ e-commerce website from your own website, or host it in an "iframe". To do this the most effectively the information here will be useful to you or your web developer.
+
You can link to your FindIt unit advertising website or Platinum O+ e-commerce website from your own website, or host it in an "iframe". To do this the most effectively the information here will be useful to you or your web developer.
  
 
== More Information ==
 
== More Information ==
Line 6: Line 6:
 
=== Where is my website? ===
 
=== Where is my website? ===
 
First of all, to find your FindIt or e-commerce website:
 
First of all, to find your FindIt or e-commerce website:
* Go to {{Menu|Reports & Parameters|Maintenance Options|Platinum O and Catalyst FindIt|Online Control Panel}}.
+
* Go to {{Menu|{{RP}}|Maintenance Options|Platinum O and Catalyst FindIt|Online Control Panel}}.
 
* To link to your website copy and paste the displayed URL into your web browser. It will be something like:
 
* To link to your website copy and paste the displayed URL into your web browser. It will be something like:
: '''<nowiki>http://www.catalyst-findit.com/index.php?c=...(long number identifying your website)...</nowiki>'''
+
: <code><nowiki>http://www.catalyst-findit.com/index.php?c=...(long number identifying your website)...</nowiki></code>
  
* To link directly to your FindIt vehicle listing, take the URL above and add:
+
;Unit Search (FindIt)
: '''&dest=search'''
+
: To link directly to your FindIt unit listing, take the URL above and add: <code>&dest=search</code>
  
* To link directly to your e-commerce shop, take the URL above and add:
+
;E-Commerce Shop (eShop & eTrade)
: '''&dest=listing'''
+
: To link directly to your e-commerce shop, take the URL above and add: <code>&dest=listing</code>
  
 
=== How do I change the layout? ===
 
=== How do I change the layout? ===
 
You can adjust the layout of the screen to a certain extent to fit your main website style:
 
You can adjust the layout of the screen to a certain extent to fit your main website style:
  
* To change the width of the page to, say, 800 pixels, take the URL above and add:
+
;Width
: '''&w=800'''
+
<code>&w=</code>
 +
:*To change the width of the page to, say, 800 pixels, take the URL above and add: <code>&w=800</code>
  
* To show the website "navigation" panel on the right-hand side instead of the left, add:
+
;Navigation Panel
: '''&nav=r'''
+
<code>&nav=</code>
 +
:*To show the website "navigation" panel on the right-hand side instead of the left, add: <code>&nav=r</code>
 +
:*To hide the website "navigation" panel completely, add:<code>&nav=h</code>
  
* To hide the website "navigation" panel completely, add:
+
;Page Headings
: '''&nav=h'''
+
<code>&h=</code>
 +
:*You can hide the usual page heading images by adding: <code>&h=n</code>
  
* You can hide the usual page heading images by adding:
+
;Results per Page
: '''&h=n'''
+
<code>&rpp=</code>
 +
:*You can set the amount of results per page in your searches by, using 25 as an example adding: <code>&rpp=25</code>
 +
:*Valid amounts: 10, 25, 50, 100
  
* You can set the amount of results per page in your searches by, using 25 as an example adding:
+
=== Can I show units matching a search? ===
: '''&rpp=25'''
+
You can have links on your site that would show only certain units by performing a search:
:Valid amounts: 10, 25, 50, 100
 
  
=== Can I show vehicles matching a search? ===
+
You can limit your search to specific data types with the following options;
You can have links on your site that would show only certain vehicles by performing a search:
 
  
;&dest=search: Add this to go straight to the FindIt (vehicle) search results, or omit it to go to the home page.
+
==== Website address parameters ====
 
+
;Unit Type
;&dest=listing: Add this to go straight to the Platinum O+ online store page.
+
:<code>&t=</code>
 
+
:* To perform a search for, say, your motorcycles only, add:<code>&t=1</code>
;&vat=ex: Add this to show VAT-exclusive prices by default in the Platinum O+ online store.
 
 
 
;&s=''yamaha+r1'': Searches for vehicles with "yamaha" and "r1" in the details, features or notes. You must use only letters and numbers, and separate words with a plus symbol (+).
 
 
 
;&t=''4'': Searches for type "4" (motorhomes) only. The different types are currently:
 
 
:* 1: Motorcycles
 
:* 1: Motorcycles
 
:* 2: Cars
 
:* 2: Cars
Line 52: Line 51:
 
:* 4: Motorhomes
 
:* 4: Motorhomes
 
:* 5: Agricultural Machinery
 
:* 5: Agricultural Machinery
:* 6: Boats (not currently used)
+
:* 6: Boats
 +
:* 7: Quad Bikes and ATVs
 +
:* 8: Trucks
 +
:* 9: Commercial Vehicles
 +
:* 10: Tricycles and Quadricycles
 +
:* 11: Caravan Accessories
 +
:* 12: Electric Assisted Pedal Cycles
 +
:* 13: Pedal Bicycles
 +
:* 14: Trailers
 +
:* 15: Plant Machinery
  
;&n=''y'': Searches for new vehicles only.
+
;New or Used?
;&n=''n'': Searches for used vehicles only.
+
:<code>&n=</code>
 +
:* To search for new units only add: <code>&n=y</code>
 +
:* To search for used units only add: <code>&n=n</code>
  
;&l=''42'': Searches for vehicles at the dealer's site "42" only. To find the appropriate id of a site: go to the dealer's home page, choose the desired site from the {{DataPrompt|Location...}} selection, hit {{Button|Search}} and find '''&l=''' in the page URL.
+
;Location
 +
:<code>&l=</code>
 +
:* <code>&l=42</code> would search for units at the dealer's site {{DataValue|42}} only. To find the appropriate id of a site: go to the dealer's home page, choose the desired site from the {{DataPrompt|Location...}} selection, hit {{Button|Search}} and find <code>&l=</code> in the page URL.
  
;&bth=''4'': Searches for 4 berth caravans or motorhomes. The number can be from 1 to 9.
+
;Caravan Berths
 +
:<code>&bth=</code>
 +
:* To search for 4 berth caravans or motorhomes add: <code>&bth=4</code>.
 +
:* The number can be from 1 to 9.
  
;&mincc=''1400'': Searches for vehicles with engine size no less than ''1400''cc.
+
;Engine Size
 +
:<code>&mincc=</code> and <code>&maxcc=</code>
 +
:* To restrict the search to units with an engine size of no less than {{DataValue|1400cc}} add : <code>&mincc=1400</code>.
 +
:* To restrict the search to units with an engine size of no more than {{DataValue|2000cc}} add : <code>&mincc=2000</code>.
  
;&maxcc=''2000'': Searches for vehicles with engine size no more than ''2000''cc.
+
;Price
 +
:<code>&minp=</code> and <code>&maxp=</code>
 +
:* To restrict the search to units with a price no less than {{DataValue|£4000}} add : <code>&minp=4000</code>.
 +
:* To restrict the search to units with a price no more than {{DataValue|£8000}} add : <code>&maxp=8000</code>.
  
;&minp=''4000'': Searches for vehicles with price no less than £''4000''.
+
;Unit Year
 +
:<code>&miny=</code> and <code>&maxy=</code>
 +
:* To restrict the search to units with a year no less than {{DataValue|2005}} add : <code>&miny=2005</code>.
 +
:* To restrict the search to units with a year no more than {{DataValue|2010}} add : <code>&maxy=2010</code>.
  
;&maxp=''8000'': Searches for vehicles with price no more than £''8000''.
+
==== Search Text ====
 +
* To perform a text search for, say "yamaha r1", take the URL above and add the following (note that spaces have to be replaced with a plus (+) symbol):
 +
<code>&s=yamaha+r1</code>
  
;&miny=''1999'': Searches for vehicles manufactured in 1999 or after.
+
{{Note|text=The following specific search options should added using the <code>&s=[options]</code> format and be separated by a space, while the search area and search term should be seperated by a colon ({{DataValue|:}}).}}
  
;&maxy=''2002'': Searches for vehicles manufactured in 2002 or before.
+
;Make
 +
: <code>make:Suzuki</code> will search for a {{DataValue|Suzuki}}.
  
=== Can I control what gets shown on my e-commerce pages? ===
+
;Model
You can customise the information displayed on your web shop in the following ways:
+
: <code>model:GSXR</code> will search for all GSXR models.
 +
 
 +
;Description
 +
: <code>description:fast</code> would search for units with {{DataValue|fast}} within the items description.
 +
 
 +
;Colour
 +
: <code>colour:red</code> would search for units that are {{DataValue|red}}.
 +
 
 +
;Notes
 +
: <code>notes:fast</code> would search the notes for the term {{DataValue|fast}}.
  
* To show VAT-exclusive prices by default, take the URL above and add:
+
;Features
: '''&vat=ex'''
+
: <code>features:airbags</code> would search for {{DataValue|airbags}} within the units feature list
: Note that once a customer creates an account and logs in, the site will automatically include VAT in prices, or not, depending on their registered country and business VAT details.
 
  
=== How can I change my style? ===
+
;Type
If you would like to change the style of the linked "iframe" this can be done using a {{FileExt|css}} file that you will need to create using the elements from the '''"FindIt"''' or '''"e-commerce website"'''.{{Tip|iconsize=small|text=If you would like to know what an element is on the page then ''(using Firefox or Chrome)'' you can right mouse click on an item/section and got to ''"Inspect Element"'' then enter this into the {{FileExt|css}} file you create.}}
+
: <code>type:scooter</code> would search for a unit that has been advertised as being a {{DataValue|scooter}}. For a car, this could be {{DataValue|saloon}} or {{DataValue|cabriolet}} etc.
  
*This {{FileExt|css}} file will need to be hosted by you.
+
;Fuel
*You will then need to inform "Catalyst Support" of the URL for the location of the file who will attach it to your account.
+
: <code>fuel:petrol</code> would search for units that run on {{DataValue|petrol}}.
*Any further changes you may want can be done using this file, without any intervention from Catalyst.
 
{{Tip|iconsize=small|text=When creating the {{FileExt|css}} file it is recommended to only include the elements of the items you wish to change. Which will help when to stop confusion of the elements you are changing.}}
 
  
{{Note|title=Important|text=As this service is free for client's with a current maintenance or rental agreement your attention is drawn to the "Internet based Services" section of the current Platinum Terms of Use (Available from the "Login" screen of Platinum on the latest version of Platinum available [[Downloading a Platinum Update|here]]) which states that the Catalyst Copyright Footer should be visible on each page.}}
+
;Gears
 +
: <code>gears:6</code> would search for the term {{DataValue|6}} within the transmission type.
  
=== Can I search specific area's during search ===
+
;Category
 +
: <code>category:racing</code> would search for units advertised as a type of unit used for {{DataValue|racing}}.
  
Yes, you can use parameters to check certain area's of text, to limit your results.
+
All search terms entered/added without the first part ('''[here]:[not here]''') will be searched for using the normal searching procedure.
  
The following options are available to use;
+
{{Example|text=
* make, model, description, colour, notes, features, type, fuel, gears, category
+
To search for a {{DataValue|green honda YZF}}, you would use;
 +
<code>&s=make:honda model:yzf colour:green</code>
  
'''NOTE:''' All specific search options should added using the '''&s=[options]''' format and be separated by a space, while the search area and search term should be seperated by a colon (''':''')
+
To search for a {{DataValue|blue tourer}}, you would use;
 +
<code>&s=colour:blue category:tourer</code>
 +
}}
  
'''Make'''
+
==== Can I stop the search expanding it's search past the given term? ====
* '''make:Suzuki''' will search for a Suzuki
+
Yes, you can do this by turning off the wider search function, by adding the following to your URL
  
'''Model'''
+
<code>&nws</code>
* '''model:GSXR''' will search for all GSXR models.
+
* Note: <code>=xxx</code> is not required for this
  
'''Description'''
+
=== Can I control what gets shown on my e-commerce pages? ===
* '''description:fast''' would search for vehicles with '''fast''' within the items description
+
You can customise the information displayed on your web shop in the following ways:
  
'''Colour'''
+
;V.A.T.
* '''colour:red''' would search for vehicles that are red
+
<code>&vat=</code>
 +
:* To show VAT-exclusive prices by default, take the URL above and add: <code>&vat=ex</code>
  
'''Notes'''
+
:{{Note|text=Once a customer creates an account and logs in, the site will automatically include V.A.T. in prices, or not, depending on their registered country and business V.A.T. details.}}
* '''notes:fast''' would search the notes for the term "fast"
 
  
'''Features'''
+
=== How can I change my style? ===
* '''features:airbags''' would search for "airbags" within the vehicles feature list
+
If you would like to change the style of the linked "iframe" this can be done using a {{FileExt|css}} file that you will need to create using the elements from the '''"FindIt"''' or '''"e-commerce website"'''.
  
'''Type'''
+
{{Tip|text=If you would like to know what an element is on the page then ''(using Firefox or Chrome)'' you can right mouse click on an item/section and got to ''"Inspect Element"'' then enter this into the {{FileExt|css}} file you create.}}
* '''type:scooter''' would search for a vehicle that has been advertised as being a scooter. For a car, this could be saloon or cabriolet etc.
 
  
'''Fuel'''
+
*This {{FileExt|css}} file will need to be hosted by you.
* '''fuel:diesel''' would search for vehicles that run on diesel
+
*You will then need to inform "Catalyst Support" of the URL for the location of the file who will attach it to your account.
 +
*Any further changes you may want can be done using this file, without any intervention from Catalyst.
  
'''Gears'''
+
{{Tip|title=Tip|text=The .css file is loaded server-side and then included in the webpage online. It is done this way to avoid potential browser warnings that can occur if the .css file is only accessible via http: and not https:. Some caching is involved, so if you make changes and want to see the result straight away you can close/reopen your browser or clear cookies, etc.}}
* '''gears:6''' would search for the term "6" within the transmission type
 
  
'''Category'''
+
{{Tip|title=Tip|text=When creating the {{FileExt|css}} file it is recommended only to include the elements of the items you wish to change. This should help avoid confusion of the elements you are changing.}}
* '''category:racing''' would search for vehicles advertised as a type of vehicle used for racing
 
  
All search terms entered/added without the first part ('''[here]:[not here]''') will be searched for using the normal searching procedure.
+
{{Note|text=As this service is free for clients with a current maintenance or rental agreement your attention is drawn to the "Internet based Services" section of the current Platinum Terms of Use (Available from the "Login" screen of Platinum on the latest version of Platinum available [[Downloading a Platinum update|here]]) which states that the Catalyst Copyright Footer should be visible on each page. ''The Current Terms and Conditions Can be found [https://www.catalyst-uk.com/ccs/catalyst-computer-systems/company/terms Here]''.}}
  
'''EXAMPLES'''
+
=== How do I scroll to the top of the iframe on page load? ===
To search for a green honda YZF, you would use;
+
If you have particularly long pages and would like to scroll the user back to the top of the page when they click on an item, then you can add the following piece of code to the <code><iframe></code> element:
* &s=make:honda model:yzf colour:green
+
<pre>
 +
onload="scrollTo(0,0);"
 +
</pre>
 +
This will ensure that every page in the <code><iframe></code> is loaded at the top. (To tweak the exact position of the page, alter the second number in the brackets, e.g. <code>onload="scrollTo(0,450);"</code>.)
  
To search for a blue tourer, you would use;
+
== See also ==
* &s=colour:blue category:tourer
+
* [[Downloading a Platinum update]]
 +
* [[HTML tags]]
 +
* [[How do I add items to my ecommerce website?]]
 +
* [[How do I add news to my website?]]
  
{{KB_Tags|Platinum online, Platinum O+, E-Commerce, ecommerce, webshop, web shop, FindIt, Find It, vehicle, advertising, iframe, host, link, customise, customize}}{{KB_POnline}}
+
{{KB_Tags|platinum online, platinum o+, e-commerce, ecommerce, webshop, web shop, findit, find it, vehicle, advertising, iframe, host, link, customise, customize}}
 +
{{How}}{{KB_PlatinumO}}

Latest revision as of 05:34, 19 June 2019

Summary

You can link to your FindIt unit advertising website or Platinum O+ e-commerce website from your own website, or host it in an "iframe". To do this the most effectively the information here will be useful to you or your web developer.

More Information

Where is my website?

First of all, to find your FindIt or e-commerce website:

  • Go to " Reports & Settings Maintenance Options Platinum O and Catalyst FindIt Online Control Panel".
  • To link to your website copy and paste the displayed URL into your web browser. It will be something like:
http://www.catalyst-findit.com/index.php?c=...(long number identifying your website)...
Unit Search (FindIt)
To link directly to your FindIt unit listing, take the URL above and add: &dest=search
E-Commerce Shop (eShop & eTrade)
To link directly to your e-commerce shop, take the URL above and add: &dest=listing

How do I change the layout?

You can adjust the layout of the screen to a certain extent to fit your main website style:

Width

&w=

  • To change the width of the page to, say, 800 pixels, take the URL above and add: &w=800
Navigation Panel

&nav=

  • To show the website "navigation" panel on the right-hand side instead of the left, add: &nav=r
  • To hide the website "navigation" panel completely, add:&nav=h
Page Headings

&h=

  • You can hide the usual page heading images by adding: &h=n
Results per Page

&rpp=

  • You can set the amount of results per page in your searches by, using 25 as an example adding: &rpp=25
  • Valid amounts: 10, 25, 50, 100

Can I show units matching a search?

You can have links on your site that would show only certain units by performing a search:

You can limit your search to specific data types with the following options;

Website address parameters

Unit Type
&t=
  • To perform a search for, say, your motorcycles only, add:&t=1
  • 1: Motorcycles
  • 2: Cars
  • 3: Caravans
  • 4: Motorhomes
  • 5: Agricultural Machinery
  • 6: Boats
  • 7: Quad Bikes and ATVs
  • 8: Trucks
  • 9: Commercial Vehicles
  • 10: Tricycles and Quadricycles
  • 11: Caravan Accessories
  • 12: Electric Assisted Pedal Cycles
  • 13: Pedal Bicycles
  • 14: Trailers
  • 15: Plant Machinery
New or Used?
&n=
  • To search for new units only add: &n=y
  • To search for used units only add: &n=n
Location
&l=
  • &l=42 would search for units at the dealer's site '42' only. To find the appropriate id of a site: go to the dealer's home page, choose the desired site from the "Location..." selection, hit [Search] and find &l= in the page URL.
Caravan Berths
&bth=
  • To search for 4 berth caravans or motorhomes add: &bth=4.
  • The number can be from 1 to 9.
Engine Size
&mincc= and &maxcc=
  • To restrict the search to units with an engine size of no less than '1400cc' add : &mincc=1400.
  • To restrict the search to units with an engine size of no more than '2000cc' add : &mincc=2000.
Price
&minp= and &maxp=
  • To restrict the search to units with a price no less than '£4000' add : &minp=4000.
  • To restrict the search to units with a price no more than '£8000' add : &maxp=8000.
Unit Year
&miny= and &maxy=
  • To restrict the search to units with a year no less than '2005' add : &miny=2005.
  • To restrict the search to units with a year no more than '2010' add : &maxy=2010.

Search Text

  • To perform a text search for, say "yamaha r1", take the URL above and add the following (note that spaces have to be replaced with a plus (+) symbol):

&s=yamaha+r1

The following specific search options should added using the &s=[options] format and be separated by a space, while the search area and search term should be seperated by a colon (':').
Make
make:Suzuki will search for a 'Suzuki'.
Model
model:GSXR will search for all GSXR models.
Description
description:fast would search for units with 'fast' within the items description.
Colour
colour:red would search for units that are 'red'.
Notes
notes:fast would search the notes for the term 'fast'.
Features
features:airbags would search for 'airbags' within the units feature list
Type
type:scooter would search for a unit that has been advertised as being a 'scooter'. For a car, this could be 'saloon' or 'cabriolet' etc.
Fuel
fuel:petrol would search for units that run on 'petrol'.
Gears
gears:6 would search for the term '6' within the transmission type.
Category
category:racing would search for units advertised as a type of unit used for 'racing'.

All search terms entered/added without the first part ([here]:[not here]) will be searched for using the normal searching procedure.

To search for a 'green honda YZF', you would use;

&s=make:honda model:yzf colour:green

To search for a 'blue tourer', you would use;

&s=colour:blue category:tourer

Can I stop the search expanding it's search past the given term?

Yes, you can do this by turning off the wider search function, by adding the following to your URL

&nws

  • Note: =xxx is not required for this

Can I control what gets shown on my e-commerce pages?

You can customise the information displayed on your web shop in the following ways:

V.A.T.

&vat=

  • To show VAT-exclusive prices by default, take the URL above and add: &vat=ex
Once a customer creates an account and logs in, the site will automatically include V.A.T. in prices, or not, depending on their registered country and business V.A.T. details.

How can I change my style?

If you would like to change the style of the linked "iframe" this can be done using a '.css' file that you will need to create using the elements from the "FindIt" or "e-commerce website".

If you would like to know what an element is on the page then (using Firefox or Chrome) you can right mouse click on an item/section and got to "Inspect Element" then enter this into the '.css' file you create.
  • This '.css' file will need to be hosted by you.
  • You will then need to inform "Catalyst Support" of the URL for the location of the file who will attach it to your account.
  • Any further changes you may want can be done using this file, without any intervention from Catalyst.
Tip: The .css file is loaded server-side and then included in the webpage online. It is done this way to avoid potential browser warnings that can occur if the .css file is only accessible via http: and not https:. Some caching is involved, so if you make changes and want to see the result straight away you can close/reopen your browser or clear cookies, etc.
Tip: When creating the '.css' file it is recommended only to include the elements of the items you wish to change. This should help avoid confusion of the elements you are changing.
As this service is free for clients with a current maintenance or rental agreement your attention is drawn to the "Internet based Services" section of the current Platinum Terms of Use (Available from the "Login" screen of Platinum on the latest version of Platinum available here) which states that the Catalyst Copyright Footer should be visible on each page. The Current Terms and Conditions Can be found Here.

How do I scroll to the top of the iframe on page load?

If you have particularly long pages and would like to scroll the user back to the top of the page when they click on an item, then you can add the following piece of code to the <iframe> element:

onload="scrollTo(0,0);"

This will ensure that every page in the <iframe> is loaded at the top. (To tweak the exact position of the page, alter the second number in the brackets, e.g. onload="scrollTo(0,450);".)

See also


Feedback
Thank you for using our Knowledge Base, we value your feedback. Did you find this article useful? 'Yes' or 'No'
Keywords AND Misspellings
platinum online, platinum o+, e-commerce, ecommerce, webshop, web shop, findit, find it, vehicle, advertising, iframe, host, link, customise, customize