Branding with confidence - Revision history

LukeWallin: /* Changing the theme */

2025-05-01T13:44:58Z

Changing the theme

← Older revision		Revision as of 13:44, 1 May 2025
Line 66:		Line 66:

	Open the branding configuration file in a text editor:		Open the branding configuration file in a text editor:
			(Note if this file does not exist, copy it from lib/cfg.d/branding.pl)

	archives/ARCHIVEID/cfg/cfg.d/branding.pl		archives/ARCHIVEID/cfg/cfg.d/branding.pl

Drn@ecs.soton.ac.uk at 10:55, 3 March 2022

2022-03-03T10:55:08Z

← Older revision		Revision as of 10:55, 3 March 2022
Line 3:		Line 3:
	One of the most common EPrints customisations is to add your own institution's branding and "look and feel" to the interface - this may include logos, page layouts, stylesheets and colour schemes.		One of the most common EPrints customisations is to add your own institution's branding and "look and feel" to the interface - this may include logos, page layouts, stylesheets and colour schemes.

	It is ~~general~~ advised that you have command line access to the server so you can add/edit these files for branding directly. Alternatively you may have some means of mapping EPrints on a network drive so you can edit these files with a graphical text editor or your own computer. It is possible to use the ''Config. Tools -> View Configuration'' section of the EPrints Admin web interface. However, this is discouraged, as anything beyond minor changes runs the risk of breaking EPrints in a way where you can no longer access these ''View Configuration'' pages to revert the changes you have made.		It is generally advised that you have command line access to the server so you can add/edit these files for branding directly. Alternatively you may have some means of mapping EPrints on a network drive so you can edit these files with a graphical text editor or your own computer. It is possible to use the ''Config. Tools -> View Configuration'' section of the EPrints Admin web interface. However, this is discouraged, as anything beyond minor changes runs the risk of breaking EPrints in a way where you can no longer access these ''View Configuration'' pages to revert the changes you have made.

	__TOC__		__TOC__

Drn@ecs.soton.ac.uk: Added info about how to go about editing branding and other config files.

2022-03-03T10:44:17Z

Added info about how to go about editing branding and other config files.

← Older revision		Revision as of 10:44, 3 March 2022
Line 2:		Line 2:

	One of the most common EPrints customisations is to add your own institution's branding and "look and feel" to the interface - this may include logos, page layouts, stylesheets and colour schemes.		One of the most common EPrints customisations is to add your own institution's branding and "look and feel" to the interface - this may include logos, page layouts, stylesheets and colour schemes.

			It is general advised that you have command line access to the server so you can add/edit these files for branding directly. Alternatively you may have some means of mapping EPrints on a network drive so you can edit these files with a graphical text editor or your own computer. It is possible to use the ''Config. Tools -> View Configuration'' section of the EPrints Admin web interface. However, this is discouraged, as anything beyond minor changes runs the risk of breaking EPrints in a way where you can no longer access these ''View Configuration'' pages to revert the changes you have made.

	__TOC__		__TOC__

Drn@ecs.soton.ac.uk: /* Adding a logo */

2022-03-03T10:37:18Z

Adding a logo

← Older revision		Revision as of 10:37, 3 March 2022
Line 13:		Line 13:
	'''Example 1'''		'''Example 1'''

	The simplest approach, which will require command line access to the server, as this cannot be done safely through the ''Config. Tools -> View Configuration'' section of the EPrints Admin web interface, is to overwrite the default EPrints logo with a copy of your own logo. Copy your logo (e.g. using SCP or SFTP) to:		The simplest approach, (which will require command line access to the server, as this cannot be done safely through the ''Config. Tools -> View Configuration'' section of the EPrints Admin web interface), is to overwrite the default EPrints logo with a copy of your own logo. Copy your logo (e.g. using SCP or SFTP) to:

	EPRINTS_PATH/archives/ARCHIVEID/cfg/static/images/sitelogo.png		EPRINTS_PATH/archives/ARCHIVEID/cfg/static/images/sitelogo.png

Drn@ecs.soton.ac.uk: Clarified how changing logo example work in real life.

2022-03-03T10:36:32Z

Clarified how changing logo example work in real life.

← Older revision		Revision as of 10:36, 3 March 2022
Line 11:		Line 11:
	===Adding a logo===		===Adding a logo===

	'''Example 1		'''Example 1'''

	The simplest approach is to overwrite the default EPrints logo with a copy of your own logo. Copy your logo to:		The simplest approach, which will require command line access to the server, as this cannot be done safely through the ''Config. Tools -> View Configuration'' section of the EPrints Admin web interface, is to overwrite the default EPrints logo with a copy of your own logo. Copy your logo (e.g. using SCP or SFTP) to:

	archives/ARCHIVEID/cfg/static/images/sitelogo.png		EPRINTS_PATH/archives/ARCHIVEID/cfg/static/images/sitelogo.png

	And refresh the page. Your logo should now be displayed in place of the default EPrints logo.		And refresh the web page. Your logo should now be displayed in place of the default EPrints logo.

	'''Example 2		'''Example 2'''

	The image that EPrints uses for the site logo is defined in the branding configuration file. You can change this setting to point to the logo image on your institution's Web page.		The image that EPrints uses for the site logo is defined in the branding configuration file. You can change this setting to point to the logo image on your institution's Web page.

	Open the branding configuration file in a text editor:		Open the branding configuration file in a text editor (e.g. Vim or Nano) if you are editing it from the command line:

	archives/ARCHIVEID/cfg/cfg.d/branding.pl		EPRINTS_PATH/archives/ARCHIVEID/cfg/cfg.d/branding.pl

			You can alternatively edit this file via the '''Config. Tools -> View Configuration''' section of the EPrints Admin web interface, under just:

			cfg/cfg.d/branding.pl

	Find the site_logo configuration setting:		Find the site_logo configuration setting:
Line 41:		Line 45:
	Reload the EPrints configuration by typing:		Reload the EPrints configuration by typing:

	bin/epadmin reload ARCHIVEID		EPRINTS_PATH/bin/epadmin reload ARCHIVEID

			If you are doing this via the EPrints Admin web interface click on the '''Reload Configuration''' button under the '''Config. Tools''' tab.

	'''Example 3		'''Example 3'''

	You can also adjust the site_logo configuration setting to point any local image file. Place a copy of your logo image somewhere in the ~~/opt/eprints3~~/archives/ARCHIVEID/cfg/static/images/ directory and then update the branding configuration file to point to it.		You can also adjust the <tt>site_logo</tt> configuration setting to point any local image file using a text editor at the command line. Place a copy (e.g. using SCP of SFTP) of your logo image somewhere in the <tt>EPRINTS_PATH/archives/ARCHIVEID/cfg/static/images/</tt> directory and then update the branding configuration file to point to it.

	<source lang="perl">		<source lang="perl">
Line 53:		Line 59:
	Reload the EPrints configuration by typing:		Reload the EPrints configuration by typing:

	bin/epadmin reload ARCHIVEID		EPRINTS_PATH/bin/epadmin reload ARCHIVEID

	===Changing the theme===		===Changing the theme===

Tdb01r at 16:21, 27 February 2012

2012-02-27T16:21:51Z

← Older revision		Revision as of 16:21, 27 February 2012
Line 1:		Line 1:
	[[Category:Branding]]		[[Category:Branding]]
	~~{{Workswith\|3.3=1}}~~

	One of the most common EPrints customisations is to add your own institution's branding and "look and feel" to the interface - this may include logos, page layouts, stylesheets and colour schemes.		One of the most common EPrints customisations is to add your own institution's branding and "look and feel" to the interface - this may include logos, page layouts, stylesheets and colour schemes.

Tdb01r at 16:20, 27 February 2012

2012-02-27T16:20:18Z

← Older revision		Revision as of 16:20, 27 February 2012
Line 1:		Line 1:
	[[Category:Branding]]		[[Category:Branding]]
			{{Workswith\|3.3=1}}

	One of the most common EPrints customisations is to add your own institution's branding and "look and feel" to the interface - this may include logos, page layouts, stylesheets and colour schemes.		One of the most common EPrints customisations is to add your own institution's branding and "look and feel" to the interface - this may include logos, page layouts, stylesheets and colour schemes.

Tdb01r: /* Adding dynamic content */

2012-02-27T16:17:39Z

Adding dynamic content

← Older revision		Revision as of 16:17, 27 February 2012
Line 358:		Line 358:
	Reload the dynamic template configuration:		Reload the dynamic template configuration:

	bin/epadmin ARCHIVEID		bin/epadmin reload ARCHIVEID

	The date should now be displayed on your repository pages.		The date should now be displayed on your repository pages.


	== See also ==		== See also ==
	* [[Branding, the next level]]		* [[Branding, the next level]]

Tdb01r: /* Adding extra images */

2012-02-27T16:16:18Z

Adding extra images

← Older revision		Revision as of 16:16, 27 February 2012
Line 208:		Line 208:

	<source lang="html4strict">		<source lang="html4strict">
	<img src="/images/small_logo.gif" />		<img src="{$config{base_url}}/images/small_logo.gif" />
	</source>		</source>

Tdb01r at 16:16, 27 February 2012

2012-02-27T16:16:03Z

Show changes