Basic URL ShortCodes

Description

Sometimes you need to display your website’s base URL, active theme URL or uploads folder URL directly inside your content editor.

Basic URL Shortcodes lets you insert important WordPress URLs using simple shortcodes inside posts, pages and widgets. Every shortcode accepts an optional path attribute so you can build a full URL in one go, and the output is escaped for you.

Available Shortcodes

[home_url]
The website’s home URL, as set in WordPress Settings.
Example: http://localhost/wp-demo

[site_url]
The URL where WordPress itself is installed. This differs from [home_url] when WordPress lives in a sub-directory.
Example: http://localhost/wp-demo/wp

[theme_url_template]
The URL of the currently active theme. Child themes are supported and return the child directory.
Example: http://localhost/wp-demo/wp-content/themes/mytheme

[parent_theme_url]
The URL of the parent theme, even when a child theme is active.
Example: http://localhost/wp-demo/wp-content/themes/parenttheme

[UPLOAD_URL] (also available as [upload_url])
The base URL of the WordPress uploads directory.
Example: http://localhost/wp-demo/wp-content/uploads

[content_url]
The URL of the wp-content directory.

[plugins_url]
The URL of the plugins directory.

[admin_url]
The URL of the WordPress admin area.
Example: [admin_url path="options-general.php"]

[rest_url]
The base URL of the REST API.
Example: [rest_url path="wp/v2/posts"]

[login_url] and [logout_url]
Login and logout URLs, with an optional redirect attribute.
Example: [login_url redirect="http://localhost/wp-demo/account"]

[current_url]
The full URL of the page currently being viewed, query string included.

Attributes

path — appended to the URL. Works on every shortcode except `[login_url]`, `[logout_url]` and `[current_url]`.

Example: [home_url path="contact"] outputs http://localhost/wp-demo/contact

For safety, a path that starts with a scheme (http:), a protocol-relative prefix (//) or a backslash is ignored, so a shortcode can never be used to point at another site.

esc — set to `raw` to skip HTML entity encoding when the value is consumed by JavaScript rather than an `href`. Defaults to `html`.

Example: [home_url esc="raw"]

redirect — where to send the visitor after login or logout. Off-site targets are rejected.

Prefixed aliases

Short tags such as [home_url] are generic and another plugin may already own them. Every shortcode is therefore also registered with a burl_ prefix — [burl_home_url], [burl_upload_url], and so on — which is guaranteed not to clash. If a tag is already taken by another plugin, this plugin leaves it alone rather than overriding it.

These shortcodes are useful when building custom layouts, inserting dynamic links or when theme customization options are limited.

Lightweight, simple and fully compatible with modern WordPress editors.

License

This plugin uses the GPLv3 license.