Persona Plugin

Skip to end of metadata
Go to start of metadata

Plugin Information

Plugin ID persona Changes In Latest Release
Since Latest Release
Latest Release
Latest Release Date
Required Core
Dependencies
2.4
Oct 02, 2013
1.447
Source Code
Issue Tracking
Maintainer(s)
GitHub
Open Issues
Kohsuke Kawaguchi (id: kohsuke)
Seiji Sogabe (id: ssogabe)
Usage Installations 2013-Apr 688
2013-May 716
2013-Jun 726
2013-Jul 768
2013-Aug 762
2013-Sep 763
2013-Oct 819
2013-Nov 819
2013-Dec 821
2014-Jan 839
2014-Feb 858
2014-Mar 857

This plugin lets you define custom personalities like Chuck Norris or Bruce Schneier just by preparing an XML file and a few image files. In this way, you can quickly define your CEO in Jenkins and earn some brownie points.

How to define a persona

By default, this plugin doesn't ship with any particular persona, so you need to define one before you use. To define a new persona, place your files in the following directory structure:

$JENKINS_HOME
+- persona
   +- BruceLee
   |  +- persona.xml
   |  +- success.jpg/.png/.gif
   |  +- failure.jpg/.png/.gif
   |  +- other.jpg/.png/.gif
   |  +- icon.jpg/.png/.gif
   +- AnotherPersona
      +- ... same set of files ...

The image files can be of any image type. The 'success' file is used as a background image for successful builds, the 'failure' file for failed builds, and the 'other' file is used for all the other kinds of builds (such as unstable, aborted, etc.) The icon file should be 48x48, and is used as a small icon placed in front of a quote.

These files can be placed anywhere under $JENKINS_HOME/persona, so long as they are side by side to each other.

The format of the persona.xml file is as follows:

<persona id='djb' displayName='Daniel J. Bernstein'>
  <quote>Just because it's automatic doesn't mean it works.</quote>
  <quote>Be careful what you wish for you just might get it.</quote>
  <quote>I do engineering, not religion.</quote>
  <quote type="success">This is only for stable builds.</quote>
  <quote type="failure">This is only for unstable builds.</quote>
  <quote type="other">This is only for failed builds.</quote>  ...
</persona>

"type" : build status such as 'success', 'failure', 'other' (case insensitive).

Reloading persona without restarting Jenkins

Send an HTTP request to http://yourserver/jenkins/reload-persona/ to have Jenkins reload your persona on the fly. This is useful when you manually added new ones or new quotes to existing ones.

Packaging your persona as a plugin

Create a plugin with your persona.xml and other image files in the top of the .hpi file. This allows you to easily share your persona with the Jenkins community.

Changelog

Version 2.4 (Oct 2, 2013)

Version 2.3 (May 12, 2013)

  • support installing plugins without restart (issue #12803).

Version 2.2 (Apr 16, 2012)

  • use prefix not to pick up a stale cache.
  • show jenkins icon with right bottom location.

Version 2.1 (Mar 5, 2012)

  • fixed that persona does not show up on Firefox.

Version 2.0 (Mar 1, 2012)

  • Reloading persona does not reloads existing persona quotes (issue #8298).
  • Allow use of random persona instead of a fix one (issue #8296).
  • Exception thrown during Persona finder on old format (issue #10166).
  • Image is misplaced in background and long text shift right column (issue #10167).
  • enables to select location to display a persona.
  • fixed several small bugs.

Version 1.3 (Mar 22, 2011)

  • Move background image to lower left

Version 1.2 (Feb 24, 2011)

  • Supported a different quote set for each build result(issue #7838).
  • Increased the icon size to 48x48.
  • Allow packaging of multiple personas as a plugin instead of only one (issue #8297).

Version 1.1 (Oct 19, 2010)

  • Fixed a path handling problem on Windows
  • Removing a persona shouldn't result in a failure to load a job that uses it
  • Added an URL to reload persona on the fly without restarting Jenkins

Version 1.0 (Oct 17, 2010)

  • First version
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.