= Varbreadcrumbs =

'''1.''' Varbreadcrumbs - is a Plone add-on product that allows you to customize breadcrumbs to your needs. This product replaces the standard way of breadcrumbs generation by a different one if needed.

Such kind of breadcrumbing is used in those situation when site structure (the way we can get to a page) is different from the structure by folders. It sometimes may also be preferable for SEO purposes.
 
On sites, where varbreadcrumbs is installed, breadcrumbs are generated in the same way as it is done by default in Plone (folders, subfolders indicated), with one exception: objects, which possess breadcrumbs property, insert objects, that are indicated in their property before their own title in a breadcrumbs path. Such a customized breadcrumbing works only with those objects, where breadcrumbs property is written.  On pages where it is not specified, breadcrumbs will be generated in a usual way.

Imagine we have a folder '''incorporate''', which includes pages:

* '''Incorporate''' (!http://www.portal.com/incorporate/index.asp) - a default page for this folder;
    

* '''Where to Incorporate''' (!http://www.portal.com/incorporate/whereto.asp);
    

* '''Incorporate in Any State''' (!http://www.portal.com/incorporate/states.asp);
    

* '''Incorporate in Nebraska''' (!http://www.portal.com/incorporate/nebraska.asp).

The peculiarity of this folder is that its content is organized in such a way that you can visit '''Incorporate in Any State''' (states.asp) page only after you visit '''Where to Incorporate''' page (whereto.asp), link from which leads to '''states.asp'''. Similarly with '''nebraska.asp''': you can visit '''Incorporate in Nebraska''' page only after visiting '''Incorporate in Any State''' page, which require initial visit to '''Where to Incorporate''' page. Another ways of visiting either states.asp or nebraska.asp are impossible, as those page titles are not present in navigation tree. The only way to visit them is through other pages.

Thus, not to get lost on site, breadcrumbs can be really helpful, providing you a clear picture of the way you get to a page.

Thus, when we are on '''incorporate''' default page, the breadbrumbs look:  '''''Home -> incorporate'''''

When on '''Where to Incorporate''': '''''Home -> incorporate -> Where to incorporate'''''

When on '''Incorporate in Any State''' breadcrumbs should be: '''''Home -> incorporate -> Where to incorporate -> Incorporate in Any State'''''

Finally, when on '''Incorporate in Nebraska''': '''''Home -> incorporate -> Where to incorporate -> Incorporate in Any State -> Incorporate in Nebraska'''''

Notice, that all three pages are in the same folder, and breadcrumbs show how we got to one page from another.

== How to organize breadcrumbs in a desired way? ==

As we need a special breadcrumbing for '''states.asp''' page, we go to ZMI interface (add  '''/manage_main''' to page URL), and chose '''Properties''' tab. Add a new property:
      name - breadcrumbs

      type - lines

Now fill the value field with '''whereto.asp''' and save the changes:


[[Image(breadcrumbs1.png, nolink)]]



Now, if we go to '''Incorporate in Any State''' (states.asp) page, the breadcrumbs will look as we needed:

'''''Home -> incorporate -> Where to incorporate -> Incorporate in Any State'''''

[[Image(states.png, nolink)]]



The same way, if we need a special breadcrumbing for the page '''Incorporate in Nebraska''' (nebraska.asp), go to ZMI interface and chose '''Properties''' tab. Add a new property with name - breadcrumbs, type - lines.

Fill the value field with '''whereto.asp''' and '''states.asp''', save the changes:

[[Image(breadcrumbs2.png, nolink)]]

Thus, breadcrumbs on '''Incorporate in Nebraska''' page are the following:

[[Image(nebraska.png, nolink)]]

 

'''2.'''  Varbreadcrumbs product allows you set silo titles for breadcrumbs items, different from object title (common feature with  [http://projects.quintagroup.com/products/wiki/qSiloBreadcrumbs qSilobreadcrumbs]). 
To do it, go to the folder that includes items, that are to be renamed. Go to folder properties (in ZMI interface), and change the existing titles to what you need ('''Properties Tab, silo_items field'''). Let's change the existing title '''Incorporate Your Business''' for '''why.asp''' page to '''Reasons To Incorporate''':   

[[Image(silo-items.png, nolink)]]

Thus, '''why.asp''' page looks this way:

[[Image(why.png, nolink)]]



'''3.''' This product also adds default page in breadcrumbs item urls. Thus links go not to a folder, but to a default page of this folder. For example, in such a breadcrumb '''''Home -> incorporate -> Where to incorporate -> Incorporate in Any State'''''
Link from '''incorporate''' will point to default page '''index.asp''' - !http://www.portal.com/incorporate/index.asp.