Ecommerce Software | Shopping Cart Software

ekmPowershop is the easiest way to setup your own online shop

Home

	Guides & Articles

	User Guide & Tutorials

	FAQ's

	ekmCommunity


Your Account

Select Currency

ekmTags: [ekm:dropdownmenu]

This tag outputs a DHTML Dynamic Menu which displays all the categories within your store up to two levels deep.

Full Tag

[ekm:dropdownmenu]

    'layout sizes
      menuwidth='auto';
      button_height='auto';
      sub_button_height='auto';

    ' Advanced Data Manipulation
      orderby='orderlocation, name';
      include_links='auto';

    'Change the colours and fonts
      background_colour='auto';
      button_colour='auto';
      button_colour_hover='auto';
      sub_button_colour='auto';
      sub_button_colour_hover='auto';
      link_colour='auto';
      link_colour_hover='auto';

    'Fonts
      font_align='auto';
      font_size='auto';
      font_family='auto';

    'Borders
      border_size='auto';
      border_colour='auto';
      sub_border_size='auto';
      sub_border_colour='auto';

    'Image options
      extra_option_displayimage='auto';
      extra_option_imagepath='auto';
      extra_option_imagewidth ='auto';
      extra_option_imageheight='auto';
      extra_sub_option_displayimage='auto';
      extra_sub_option_imagepath='auto';
      extra_sub_option_imagewidth ='auto';
      extra_sub_option_imageheight='auto';

    'Include extra links in this menu
      extralinks_above='
          [link="index.asp"]home[/link]
          [link="#"] [/link]
      ';
      extralinks_below='
          [link="#"] [/link]
          [link="http://www.ekmSystems.co.uk/"] ekmSystems [/link]
      ';

    'Do the edit buttons display (when logged in)
      edit_buttons='yes';

[/ekm:dropdownmenu]

Example Output

Tag Parameters

menuwidth

Allows you to specify the width of the menu in pixels.

Possible Values
auto	150 pixels
User Defined	Size in pixels (e.g. 200)

button_height

Allows you to specify the height of the menu buttons in pixels.

Possible Values
auto	20 pixels
User Defined	Size in pixels (e.g. 40)

sub_button_height

Allows you to specify the height of the sub menu buttons in pixels.

Possible Values
auto	20 pixels
User Defined	Size in pixels (e.g. 40)

orderby

Allows you to specify how your product and category data is ordered. You can use any of the database field names to order by, and you can use more than one. You can also use ASC (Ascending) and DESC (Descending)

For example: orderby='name ASC, orderlocation DESC';

Possible Values
auto	Uses orderlocation, name
orderlocation	A numeric value which is used to order the item
name	The product or category name

include_links

This will tell it whether all the buttons are links or just the sub categories.

Possible Values
yes (default)	The main buttons will link
no	Just the sub-categories will link

button_colour

Allows you to select the colour of the main menu items.

Possible Values
auto	#FFFFFF
User Defined	You can enter a Hex Colour Code, or HTML colour reference

button_colour_hover

Allows you to select the colour of the main menu items when the mouse is over them.

Possible Values
auto	#FF0000
User Defined	You can enter a Hex Colour Code, or HTML colour reference

sub_button_colour

Allows you to select the colour of the sub menu items.

Possible Values
auto	#FFFFFF
User Defined	You can enter a Hex Colour Code, or HTML colour reference

sub_button_colour_hover

Allows you to select the colour of the sub menu items when the mouse is over them.

Possible Values
auto	#FF0000
User Defined	You can enter a Hex Colour Code, or HTML colour reference

link_colour

Allows you to select the colour of the text in the menu items.

Possible Values
auto	#000000
User Defined	You can enter a Hex Colour Code, or HTML colour reference

link_colour_hover

Allows you to select the colour of the text in the menu items when they are highlighted.

Possible Values
auto	#FFFFFF
User Defined	You can enter a Hex Colour Code, or HTML colour reference

font_align

Allows you to select the alignment of the font.

Possible Values

left

center (default)

right

font_size

Allows you to select the font size.

Possible Values
auto	This is font size 9
User Defined	You can enter any whole number (e.g. 12)

font_family

Allows you to select the font family.

Possible Values
auto	This will default to 'arial,comic sans ms,technical'
User Defined	You can enter any font family in order of which will be tried first (e.g. comic sans ms,Courier New,Courier)

border_colour

Allows you to select the colour of the borders around the menu items.

Possible Values
auto	Which by default is #000000
User Defined	You can enter a Hex Colour Code, or HTML colour reference

border_size

Allows you to select the size of the borders around the menu items.

Possible Values
auto	The default is 1 pixel
User Defined	You can enter any whole number (e.g. 5)

sub_border_colour

Allows you to select the colour of the borders around the sub menu items.

Possible Values
auto	The same colour as colourhigh, which by default is #000000
User Defined	You can enter a Hex Colour Code, or HTML colour reference

sub_border_size

Allows you to select the size of the borders around the sub menu items.

Possible Values
auto	The default is 1 pixel
User Defined	You can enter any whole number (e.g. 5)

extra_option_displayimage

This will set whether the images appear when there are top level items in the dropdown

Possible Values
auto	The images will be displayed where there are top level dropdown items
no	The images will not be displayed where there are top level dropdown items

extra_option_imagepath

This allows you to specify a path to an image that will be used to signify top level item in the dropdown

Possible Values
auto	Will have a default arrow graphic
User Defined	Any image path local or remote (e.g. /ekmps/shops/yourshopname/resources/Image/my_picture.jpg or http://www.google.co.uk/intl/en_uk/images/logo.gif)

extra_option_imagewidth

This will set the width of the top level items graphic

Possible Values
auto	5 pixels
User Defined	Size in pixels (e.g. 10)

extra_option_imageheight

This will set the height of the top level items graphic

Possible Values
auto	10 pixels
User Defined	Size in pixels (e.g. 20)

extra_sub_option_displayimage

This will set whether the images appear when there are sub level items in the dropdown

Possible Values
auto	The images will be displayed where there are sub level dropdown items
no	The images will not be displayed where there are sub level dropdown items

extra_sub_option_imagepath

This allows you to specify a path to an image that will be used to signify sub level item in the dropdown

Possible Values
auto	Will have a default arrow graphic
User Defined	Any image path local or remote (e.g. /ekmps/shops/yourshopname/resources/Image/my_picture.jpg or http://www.google.co.uk/intl/en_uk/images/logo.gif)

extra_sub_option_imagewidth

This will set the width of the graphic

Possible Values
auto	5 pixels
User Defined	Size in pixels (e.g. 10)

extra_sub_option_imageheight

This will set the height of the graphic

Possible Values
auto	10 pixels
User Defined	Size in pixels (e.g. 20)

extralinks_above

Allows you to specify extra links above the dynamically generated links

Examples
[link="index.asp"] Home [/link]	Displays a link to your first page
[link="#"] [/link]	Displays a blank entry

extralinks_below

Allows you to specify extra links below the dynamically generated links

Examples
[link="http://www.ekmSystems.co.uk/"] ekmSystems [/link]	Displays a link to our site
[link="#"] [/link]	Displays a blank entry

edit_buttons

If you are logged in this will specify whether you see the edit category icons

Possible Values
yes (default)	When logged in the edit buttons will show
no	When logged in the edit buttons will not show

« Back

About Us | Site Map | Terms | Privacy

Our Services: hosted online shop - ecommerce software - shopping cart software - ecommerce hosting