Redirection Plugin

Name Redirection Plugin
Vendor CustomWare Asia Pacific (Website)
Authors David Peterson
Homepage http://www.customware.net/repository/display/AtlassianPlugins/Redirection+Plugin
Issue Management http://jira.adaptavist.com/browse/REDIR
Categories Admin Macros
Version 2.3
Availability Confluence v2.3 to v2.9-m2-r2
State Stable
License Freeware / Open Source (BSD)
Price Free
Release Docs http://www.customware.net/repository/display/AtlassianPlugins/Redirection+Plugin
Java API Docs n/a
Download Source http://svn.atlassian.com/fisheye/viewrep/public/contrib/confluence/redirection-plugin/tags/2.3
Download JAR redirection-plugin-2.3.jar
This plugin can be installed and updated via the Confluence Repository Client.

Description/Features

This plugin provides macros to facilitate page redirection and page aliasing.

This plug-in contains macros for redirecting pages and provides two basic ways to redirect. The only difference is really a matter of perspective.

  • {redirect} is generally used when a page is often linked directly outside this Confluence install but it has changed names for some reason.
  • {alias} is generally used when a page may be known by more than one name.
For more information, visit this plugin's homepage

Version History

Confluence 2.3 and newer

Version Date State License Price
Show description 2.3 (#7) 28 Feb 2007 Stable Freeware / Open Source (BSD) Free

Release Notes

Adaptavist Public Issue Tracker (2 issues)
T Key Pr Summary Updated Reporter Status
Task REDIR-15 Major Switch to a Maven 2 build. Feb 28, 2007 David Peterson Closed
Bug REDIR-14 Major Confluence 2.3 compatibility Feb 28, 2007 David Peterson Closed

Contributors

  • David Peterson — Developer

Confluence 2.2 and older

Version Date State License Price
Show description 2.3 (#7) 28 Feb 2007 Stable Freeware / Open Source (BSD) Free

Release Notes

Adaptavist Public Issue Tracker (2 issues)
T Key Pr Summary Updated Reporter Status
Task REDIR-15 Major Switch to a Maven 2 build. Feb 28, 2007 David Peterson Closed
Bug REDIR-14 Major Confluence 2.3 compatibility Feb 28, 2007 David Peterson Closed

Contributors

  • David Peterson — Developer

Labels

 
  1. Sep 19, 2005

    Mingyi Liu says:

    Thanks for the very nice macros\! They fill in some features that we really need...

    Thanks for the very nice macros! They fill in some features that we really need (like redirect after page deletion/move). Alias is a nice idea that would've been even better if it works across spaces.

    BTW, both alias and redirect worked in our 1.4.3 installation.

    1. Sep 19, 2005

      David Peterson says:

      Thanks :) There is actually no technical reason that alias can't work across sp...

      Thanks

      There is actually no technical reason that alias can't work across spaces. The main reason I haven't enabled it is that it could present potential security holes. Currently, anyone with edit access to a space can set up an alias. However, not everyone who has edit access to one space has the same permissions on another space. So, if the macro allowed cross-space aliases, what happens when a user who doesn't have edit access to the other space modifies the cross-space alias? I can't allow them to modify the other space which they don't have edit access to, but now my alias macro is out of sync with reality.

      I am planning on adding better page-rename/movement tracking to redirect in a future version, meaning that if the page the redirect is pointing to changes its name or space, the redirect updates itself automatically. This will mean you can set up a redirect and forget about it. Hopefully this will meet your cross-space alias requirements.

      Otherwise, do you have a specific example you could give me where cross-space aliasing would be useful?

      1. Oct 05, 2005

        Mingyi Liu says:

        Thanks\! I thought that security was probably a concern for alias across space. ...

        Thanks! I thought that security was probably a concern for alias across space. I don't have a specific example for cross-space aliasing, I just felt that as with redirect, across-space situations are probably more frequent than intra-space situations, especially for cases where the spaces share some info.

        That said, I felt that redirect is generally good enough for all situations. Alias is a bit tougher to get rid of, and might create problems (I opened a Confluence issue after using Alias macro in 1.4.3, deleting it, and ported it to 1.4.4 to find a nullpointerexception due to an empty-titled page left behind by Alias macro somehow). So I'd recommend redirect over alias. Is there any specific occasion where it's better to use alias over redirect, though?

        1. Oct 05, 2005

          David Peterson says:

          The difference is mostly a matter of perspective. I personally use redirect when...

          The difference is mostly a matter of perspective. I personally use redirect when a page has changed location or name, but was well-known enough to be linked elsewhere. Alias I use when I have a page which may be known by more than one name, or by it's plural form. The main advantage of alias is that it will update any aliases if the name of the original page changes. Redirect does not currently keep track (it hopefully will in the near future).

          And if you get any error messages, please feel free to post details here and I'll try to fix them for the next release. Any stack-traces are particularly useful. Just remember to put them in a {noformat} macro or it will look really bad...

          1. Oct 05, 2005

            Mingyi Liu says:

            Thanks for your reply\! I see the difference now. As for the bug I mentioned, I ...

            Thanks for your reply! I see the difference now. As for the bug I mentioned, I opened the issue at http://jira.atlassian.com/browse/CONF-4222

            1. Oct 05, 2005

              David Peterson says:

              Ah, ok. I'll make sure alias is checking that the names provided are valid pages...

              Ah, ok. I'll make sure alias is checking that the names provided are valid pages in the next version. I'm in the process of setting up a Jira projects for all my macros (kindly provided by the boys at Adaptavist), which will be the best way of reporting bugs/requesting new features in the future. Stay tuned!

      2. May 11, 2006

        Brent Haines says:

        Actually, I have a specific example if you don't mind my piping up. As an orgniz...

        Actually, I have a specific example if you don't mind my piping up.

        As an orgnization, we have created quite a few spaces as we utilize Confluence. This is pretty cool except that the various non-technical users have requested a high-level navigation for the site. I created a page hierarchy to match the top-level spaces and use the

        Unknown macro: {pagetree }
        macro to show a quick (and fairly slick) tree view of the major entry points on our Wiki. I had intended to use the
        Unknown macro: {alias }
        macro to  have these pages basically redirect to the home pages for those spaces.

        Anyway, the solution looks and works well, but alias does seem like a better fit. I actually *want* the editors of those pages to control the content even though they don't have edit access to my space.

        Now, there may be a better way to accomplish what I wanted, but this does work.

        1. May 12, 2006

          David Peterson says:

          I'm not quite sure what you're trying to achieve, or whether you're making a fea...

          I'm not quite sure what you're trying to achieve, or whether you're making a feature request or giving a working case...

          In your case, from what I think I understand, it seems to me that the {redirect} macro would serve you better than {alias} anyway... In your 'Navigation' space, create a page called 'Section X' which has '{redirect:Section X Space:Home}' as it's contents (with 'Section X Space' replaced with the appropriate space key, of course).

          Or am I misunderstanding you?

  2. Oct 01, 2005

    Guy Fraser says:

    Am I correct in thinking that you can wrap the \ macro in or macro tags to onl...

    Am I correct in thinking that you can wrap the {redirect} macro in

    Unknown macro: {show-to}
    or
    Unknown macro: {hide-from}
    macro tags to only redirect based on set criteria matched against the logged in user?

    1. Oct 01, 2005

      David Peterson says:

      Yeah, that should work. However, I am aware of a couple of bugs in the visibilit...

      Yeah, that should work. However, I am aware of a couple of bugs in the visibility macros which may cause problems. If it doesn't work, let me know the exact filters you're using and I'll make sure they work in the next version (which should be coming out within a day or two).

  3. Mar 11, 2006

    Dan Hardiker says:

    This plugin now accessable through the Confluence Repository Client.

    This plugin now accessable through the Confluence Repository Client.

  4. Apr 19, 2006

    Gee Jee says:

    Other than disableing the plugin, how do I go about editing a page that conains ...

    Other than disableing the plugin, how do I go about editing a page that conains the redirect diretive?

    1. Apr 19, 2006

      David Peterson says:

      You have to add '?redirect=false' to the end of the URL of the redirecting page....

      You have to add '?redirect=false' to the end of the URL of the redirecting page. Eg. for this page, it would be http://confluence.atlassian.com/display/CONFEXT/Redirection+Plugin?redirect=false.

  5. Sep 26, 2006

    Dave Yost says:

    In MediaWiki, you can move a page, and MW automatically inserts a redirect from ...

    In MediaWiki, you can move a page, and MW automatically inserts a redirect from the old to the new.  Do I gather that Confluence doesn't have this feature? (Otherwise, why would redirect be an optional plugin from a 3rd party?)

    1. Sep 26, 2006

      Guy Fraser says:

      The redirect plugin is designed for creating manual redirects and aliases and it...

      The redirect plugin is designed for creating manual redirects and aliases and it's free (download at top of this page).

      When you move pages in Confluence, the wiki automatically updates all links to those pages. Anything still linking to a moved page results in a "page not found" screen which intelligently lists the new page (if it was moved or renamed) and also suggests other pages with the same name, etc.

    2. Sep 26, 2006

      David Peterson says:

      Yes, that's correct. You can manually create a redirect using this plugin. That...

      Yes, that's correct. You can manually create a redirect using this plugin.

      That said, it would be quite possible to have a plugin listen for page rename/move events and automatically create a redirect page for the move. Could be worth adding as an option to this plugin. If you'd like to see that added at some point, feel free to add a feature request. I'm currently doing a walk through all my plugins updating them, so now is as good a time as any...

      1. Sep 26, 2006

        David Peterson says:

        Whoops correct location for feature requests is here

        Whoops - correct location for feature requests is here.