ExternalLinksInNewWindow

Note: The recipes here are for PmWiki versions 0.6 and 1.0 only. For PmWiki 2.0 recipes, see Cookbook.


Question

How can I configure external links to always open in a new window?

Answer

Add the following to config.php:

    $UrlLinkFmt = 
      "<a class='urllink' target='_blank' href='\$LinkUrl'>\$LinkText</a>";

Discussion

The $UrlLinkFmt variable specifies the HTML to be output when an external link is generated by PmWiki. The above line simply adds target='_blank' to the HTML so that each external link is opened in a new window.

Contributors

  • Pm - 10-Jul-2004

(more semantic) Alternative

You could use

    $UrlLinkFmt = "<a class='urllink' rel='extern' href='\$Url'>\$LinkText</a>";

in config.php.

Then put

 function externalLinks() {
 if (!document.getElementsByTagName) return;
 var anchors = document.getElementsByTagName("a");
 for (var i=0; i<anchors.length; i++) {
   var anchor = anchors[i];
   if (anchor.getAttribute("href") &&
       anchor.getAttribute("rel") == "extern")
     anchor.target = "_blank";
  }
 }
 window.onload = externalLinks;

into a file - say - 'extern.js'.

Adding

   <script type='text/javascript' src='PATH/extern.js'></script>

to your template will call the script on pageload.

For more on this - nicer - solution have a look at [(approve links) edit diff].

--SteffenGlueckselig

pmwiki-2.5.9 -- Last modified by {{gunter}}

from IP: 85.171.160.186 ip should be disabled by default for security reasons

Array
(
    [post_max_size] => 64M
    [$_POST keys] => 
    [$_REQUEST keys] => n
    [$_SERVER] => Array
        (
            [CONTEXT_DOCUMENT_ROOT] => /home/pmwiki/public_html
            [CONTEXT_PREFIX] => 
            [DOCUMENT_ROOT] => /home/pmwiki/public_html
            [GATEWAY_INTERFACE] => CGI/1.1
            [HTTPS] => on
            [HTTP_ACCEPT] => */*
            [HTTP_ACCEPT_ENCODING] => gzip, br, zstd, deflate
            [HTTP_HOST] => www.pmwiki.org
            [HTTP_USER_AGENT] => Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
            [HTTP_X_HTTPS] => 1
            [PATH] => /bin:/usr/bin
            [PHP_INI_SCAN_DIR] => /opt/cpanel/ea-php70/root/etc:/opt/cpanel/ea-php70/root/etc/php.d:.
            [QUERY_STRING] => n=Cookbook%2dV1%2fExternalLinksInNewWindow
            [REDIRECT_HTTPS] => on
            [REDIRECT_QUERY_STRING] => n=Cookbook%2dV1%2fExternalLinksInNewWindow
            [REDIRECT_SCRIPT_URI] => https://www.pmwiki.org/wiki/Cookbook-V1/ExternalLinksInNewWindow
            [REDIRECT_SCRIPT_URL] => /wiki/Cookbook-V1/ExternalLinksInNewWindow
            [REDIRECT_SSL_TLS_SNI] => www.pmwiki.org
            [REDIRECT_STATUS] => 200
            [REDIRECT_UNIQUE_ID] => afK65z20f20Z7xIwOo-9HgAAAJg
            [REDIRECT_URL] => /wiki/Cookbook-V1/ExternalLinksInNewWindow
            [REMOTE_ADDR] => 216.73.216.31
            [REMOTE_PORT] => 65050
            [REQUEST_METHOD] => GET
            [REQUEST_SCHEME] => https
            [REQUEST_URI] => /wiki/Cookbook-V1/ExternalLinksInNewWindow
            [SCRIPT_FILENAME] => /home/pmwiki/public_html/index.php
            [SCRIPT_NAME] => /index.php
            [SCRIPT_URI] => https://www.pmwiki.org/wiki/Cookbook-V1/ExternalLinksInNewWindow
            [SCRIPT_URL] => /wiki/Cookbook-V1/ExternalLinksInNewWindow
            [SERVER_ADDR] => 23.254.203.248
            [SERVER_ADMIN] => webmaster@pmwiki.org
            [SERVER_NAME] => www.pmwiki.org
            [SERVER_PORT] => 443
            [SERVER_PROTOCOL] => HTTP/1.1
            [SERVER_SIGNATURE] => 
            [SERVER_SOFTWARE] => Apache
            [SSL_TLS_SNI] => www.pmwiki.org
            [TZ] => America/Los_Angeles
            [UNIQUE_ID] => afK65z20f20Z7xIwOo-9HgAAAJg
            [PHP_SELF] => /index.php
            [REQUEST_TIME_FLOAT] => 1777515239.2019
            [REQUEST_TIME] => 1777515239
            [argv] => Array
                (
                    [0] => n=Cookbook%2dV1%2fExternalLinksInNewWindow
                )

            [argc] => 1
        )

)