Anchors in posts using vbcode

Collapse
X
 
  • Time
  • Show
Clear All
new posts
  • cbiweb
    Senior Member
    • Apr 2004
    • 2658
    • 4.1.x

    Anchors in posts using vbcode

    Overview

    HTML anchors are links that allow you to jump to a specific place within a document. This is very handy for long documents that have headings or other sections of interest to the reader. Typically, the top of the document contains a set of links to each section, and you need only to click one of those links to jump to the desired location on the page.

    Anchors would be just as useful in forums for those who want to make long posts, perhaps for tutorials, forum guidelines or similar types of posts. Since most, if not all vBulletin license holders do not allow HTML in their forums, here is way to create anchors using vbcode instead of HTML.

    Special mention goes to vBulletin Community member Cibulo, who was in need of this functionality, which inspired me to figure it out.


    Instructions

    First, you need to create two new bbcodes. Start by going to:
    Admin CP -> Custom BB Codes -> Add New BB Code

    Then fill in the relevant fields using these settings and parameters:

    Title: Anchor link
    Tag: jumpto
    Replacement: <a href="#{option}">{param}</a>
    Example: [jumpto=aname]This takes you to a new location within a post[/jumpto]
    Description: The [jumpto] tag allows you to jump to another location within a post, usually used for long posts with headings and/or sections of interest. This tag <b>must</b> be used in conjunction with the [aname] tag. One is not functional without the other.
    Use {option}: Yes
    Click Save

    Create another bbcode using these settings and parameters:

    Title: Named anchor link
    Tag: aname
    Replacement: <a name="{option}">{param}</a>
    Example: [aname=aname]This is where you jump to[/aname]
    Description: The [aname] tag is used in conjunction with the <a href="#jumpto">[jumpto]</a> tag. One is not functional without the other.
    Use {option}: Yes
    Click Save


    Implementation

    Wrap the [jumpto] tag around a link that will take the reader to another place within the post, as follows:
    Code:
    [COLOR=Navy][jumpto="anchor1"][/COLOR]link to somewhere within the post[COLOR=Navy][/jumpto][/COLOR]
    Then wrap the [aname] tag around the first word or phrase of the section you want the reader to jump to:
    Code:
    [COLOR=Navy][aname="anchor1"][/COLOR]This is where you end up[COLOR=Navy][/aname][/COLOR]
    In the above two examples, change anchor1 to whatever name you choose for the link. (For example: if you are linking to a section called "Theory of Gravity", anchor1 could be called theory). They must both be identical in order to work correctly.


    And yes, you can use these same tags for "back to top" links. Wrap the following tags around the first word of the post:

    Code:
    [COLOR=Navy][aname="top"][/COLOR]first word of your post[COLOR=Navy][/aname][/COLOR]
    And place this one in the appropriate part of the post where a reader would click it to jump back to the top:

    Code:
    [COLOR=Navy][jumpto="top"][/COLOR]back to top[COLOR=Navy][/jumpto][/COLOR]
    Last edited by cbiweb; Sat 24 Mar '07, 7:49pm. Reason: Corrected typo in a tag
    ~ Life isn't always fair, but you can be. ~

Related Topics

Collapse

Working...