cms_selflink

[eleven3]

I cannot seem to find very much documentation of what parameters are necessary for this tag.

For instance, I am trying to put an link an image in the cms wysiwyg (default).  Every time I try to browse the server, it just takes me to upload?

This is probably a user error.  Can anyone help?  Thanks.

[Russ]

It is in the tag help - to the right of the tag when looking at it in admin, click the link and you get...
Help for the cms_selflink tag
What does this do?

Creates a link to another CMSMS content page inside your template or content. Can also be used for external links with the ext parameter.
How do I use it?

Just insert the tag into your template/page like: {cms_selflink page="1"} or {cms_selflink page="alias"}
What parameters does it take?

    * (optional) page - Page ID or alias to link to.
    * (optional) dir anchor (internal links) - New option for an internal page link. If this is used then anchorlink should be set to your link.
    * (optional) anchorlink - New paramater for an internal page link. If this is used then dir ="anchor" should also be set. No need to add the #, because it is added automatically.
    * (optional) urlparam - Specify additional parameters to the URL. Do not use this in conjunction with the anchorlink parameter
    * (optional) tabindex ="a value" - Set a tabindex for the link.
    * (optional) dir start/next/prev/up (previous) - Links to the default start page or the next or previous page, or the parent page (up). If this is used page should not be set.
    * Note! Only one of the above may be used in the same cms_selflink statement!! (optional) text - Text to show for the link. If not given, the Page Name is used instead.
    * (optional) menu 1/0 - If 1 the Menu Text is used for the link text instead of the Page Name
    * (optional) target - Optional target for the a link to point to. Useful for frame and javascript situations.
    * (optional) class - Class for the link. Useful for styling the link.
    * (optional) lang - Display link-labels ("Next Page"/"Previous Page") in different languages (0 for no label.) Danish (dk), English (en) or French (fr), for now.
    * (optional) id - Optional css_id for the link.
    * (optional) more - place additional options inside the link.
    * (optional) label - Label to use in with the link if applicable.
    * (optional) label_side left/right - Side of link to place the label (defaults to "left").
    * (optional) title - Text to use in the title attribute. If none is given, then the title of the page will be used for the title.
    * (optional) rellink 1/0 - Make a relational link for accessible navigation. Only works if the dir parameter is set and should only go in the head section of a template.
    * (optional) href - If href is used only the href value is generated (no other parameters possible). Example:
    * (optional) image - A url of an image to use in the link. Example: {cms_selflink dir="next" image="next.png" text="Next"}
    * (optional) alt - Alternative text to be used with image (alt="" will be used if no alt parameter is given).
    * (optional) imageonly - If using an image, whether to suppress display of text links. If you want no text in the link at all, also set lang=0 to suppress the label. Example: {cms_selflink dir="next" image="next.png" text="Next" imageonly=1}
    * (optional) ext - For external links, will add class="external and info text. warning: only text, target and title parameters are compatible with this parameter
    * (optional) ext_info - Used together with "ext" defaults to (external link)

Hope this helps,
Russ

[Scott]

I know it is not stated here:
    * (optional) dir start/next/prev/up (previous) - Links to the default start page or the next or previous page, or the parent page (up). If this is used page should not be set.

but is there any way to get selflink to move down a page if the current page has children?

My site has a group of four arrows used to aid navigation, I need to somehow get it so that the up arrow moves to the parent if the page has a parent, the down arrow moves to the child, if the page has a child. Left and right move to sister pages on the same level but not up to a pages parent or down to a child. If the parent/child/next/prev pages does not exist arrow does not render (have this working). So far I have got the up arrow working, put the next and prev just go back and foward through all the levels and I have no down. Any idea of the changes I might need to make to get these working?

[Russ]

Isn't moving down a page from a parent, the same as moving to the next page from the parent?

Russ

[Scott]

Guess I didn't explain quite right! I dont want users to be able to go backup a level with the next arrow.  Next and prev should only brows on the same level. It is hard to explain.
You can see what I mean at: http://www.soc.soton.ac.uk/lso/teaching ... mt002b.php in the top right corner. Just trying to replicate the current system to create a consistant feel.

[Dr.CSS]

eleven3
Input image then click it and hit the self link in the tool bar and add the link, it will warn about no text just say ok.

[eleven3]

Thanks Russ, I didn't even know about the tag help.  That will help me really cut down on dumb questions.



Mark,

That didn't work for me for some reason.  Upon submission, no image shows up.  No big deal.  Ultimately I am just trying to make it easier for end users.

[Russ]

Sorry eleven3, no intention of making you look dumb. Just trying to point you in the right direction. You never know until you ask and that is what forums like this are for.

Russ

[hazz]

hey eleven, did you figure out how to make prev/next links apply to only one level?