Date: Fri, 29 Mar 2024 07:40:16 +0000 (UTC) Message-ID: <1959191398.694.1711698016560@[13.43.82.202]> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_693_869877316.1711698016555" ------=_Part_693_869877316.1711698016555 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html
This feature is accessed from the Options Tab= in the Layout Manager in Theme Builder 3.0 and ab= ove.
=
The favourites icon appears next to the URL of your wiki in the browser = and also in your bookmarks, web feeds and other locations that link to your= site. This option allows you to customise it.
=
System Administrators can set permi=
ssions to restrict who can use these options. By default, only Confluen=
ce site administrators (confluence-administrators
group) can c=
hange these options.
By default the Confluence logo is displayed, however you might want some= thing more custom and that's what this option allows you to do.
There are two formats for setting the icon - a URL (absolute or relative= ) or a shortcut to a menu icon.
Theme Builder is bundled with over 800 professional icons that can be us= ed with the menuicon macro. You'll be glad to know= that it's really easy to use any of those icons as your favourites icon.= p>
A key benefit here, over the URL based methods discussed below, is that = Theme Builder will handle the URL automatically so you don't have to worry = about protocols and domains, etc. As an added advantage Theme Builder ensur= es the icon is cached, speeding up subsequent page views.
To use an in-built icon, simply enter it's name prefixed with the "at" s= ign, for example:
@copy
That would use the "copy" icon as your favourites icon:
For a list of common menu icons, and to find out how to view a list of a= ll icons available, please see menuicon macro.
Simply enter the URL to your icon, for example:
http://www.mysite.com/images/myicon.png
The icon sh= ould be a 16x16 pixel PNG image.
You can also use relative URLs (ideal for sites that are accessible via = HTTP and HTTPS or different domain names):
/path/myicon.png
Once the icon is defined, it will start appearing in the browser URL bar= , tabs and bookmarks, etc:
=
There are three common places where images can be stored:
To do this, you'll need access privileges for the server file system. Si=
mply copy your icon to the /images
folder on the server and th=
en specify the relative path to the image.
If Confluence is clustered, you'll have to upload the image to each serv= er to ensure users can access it from each node.
The key benefit to this approach is that the icon will always be availab= le - even to logged out users.
The key disadvantage is that you'll have to re-upload the icon after eac= h Confluence upgrade so be sure to include this task in your change control= procedures.
Simply attach the icon to a page in your wiki and then right-click the l= ink to that file and copy the link location. For best results, remove the <= code>http://mysite.com part of the= URL to make it relative.
This is probably the easiest way to use a custom icon, even in a cluster= ed environment, however anonymous users (i.e. not logged in) will only be a= ble to see the icon if the page where it's attached (and the associated spa= ce and wiki as a whole) is accessible to anonymous users.
If you have some standard web space, eg. an Apache server sat in front o= f Confluence, you can serve the image from there.
If you're Confluence wiki is served from a different domain (or sub-doma=
in) to the location where the image is stored, you'll need to use an absolu=
te URL (i.e. including the http:\//mysite.com
part).
There are two possible disadvantages to using this method:
http and https
) or domains, the image URL won't automatically =
reflect the URL being used to access your wiki and this could cause problem=
s.
If you want to revert to using the default Confluence favicon, simply le= ave the Favourites Icon field empty.