@author – Joomla DocBlock headers

Please note the following:

  • This article is supporting documentation for our tutorial, using DocBlocks in Joomla.
  • There is official documentation that references what headers to use in your DocBlocks (such as @copyright and @license), but documentation is missing that outlines what values to use for each header.
  • In an effort to learn what values to use per each header, we have scanned the Joomla code and pulled out how each header is used. The idea behind this page is to show you how the @author tag has been used in the past within the Joomla code so learn how to use it in your future documentation.

Value Count

The following table shows the various different values for @author, and how many times each value has been used.

Value# Times used
* @author Andreas Gohr <[email protected]> 7
* @author Fabien Potencier <[email protected]> 7
* @author <[email protected]> 5
* @author Andy Prevost 4
* @author Chris Smith<[email protected]> 4
* @author Jim Jagielski 4
* @author Harald Kirschner <mail [at] digitarald.de> 3
* @author Rouven We�ling <me [at] rouvenwessling.de> 3
* @author Matthias Sommerfeld <[email protected]> 3
* @author Marcus Bointon 3
* @author Geoffrey Sneddon 2
* @author Anthony Ferrara <[email protected]> 2
* @author Matthew Lewinski <[email protected]> 2
* @author Romain Neutron <[email protected]> 1
* @author Jay Burrell, Systems & Networks, Mississippi State University 1
* @author Oliver Saunders <oliver (a) osinternetservices.com> 1
* @author Matthias Sommerfeld, <[email protected]> 1
* @author Matthias Sommerfeld <[email protected]> 1
* @author <chernyshevsky at hotmail dot com> 1
* @author elfrink at introweb dot nl 1
* @author Nicholas 1
* @author Nicholas K. Dionysopoulos 1
* @author Brett Stimmerman <brettstimmerman[at]gmail[dot]com> 1
* @author Matt Knapp <mdknapp[at]gmail[dot]com> 1
* @author Michal Migurski <[email protected]> 1
* @author Chris Ryan 1
* @author Richard Davey (orig) <[email protected]> 1
* @author Josh Peck <jmp at joshpeck dot org> 1
* @author nikosdion <[email protected]> 1
* @author Alexander Merz <[email protected]> 1
* @author Ryan Parman 1
* @author Geoffrey Sneddon <[email protected]> 1

Andreas Gohr <[email protected]>

This tag:
* @author Andreas Gohr <[email protected]>
has been used a total of 7 times within the following files:

libraries/phputf8/utils/specials.php:* @author Andreas Gohr <[email protected]> libraries/phputf8/utils/ascii.php:* @author Andreas Gohr <[email protected]> libraries/phputf8/trim.php:* @author Andreas Gohr <[email protected]> libraries/phputf8/trim.php:* @author Andreas Gohr <[email protected]> libraries/phputf8/trim.php:* @author Andreas Gohr <[email protected]> libraries/phputf8/native/core.php:* @author Andreas Gohr <[email protected]> libraries/phputf8/native/core.php:* @author Andreas Gohr <[email protected]> 

Fabien Potencier <[email protected]>

This tag:
* @author Fabien Potencier <[email protected]>
has been used a total of 7 times within the following files:

libraries/framework/Symfony/Component/Yaml/Parser.php: * @author Fabien Potencier <[email protected]> libraries/framework/Symfony/Component/Yaml/Yaml.php: * @author Fabien Potencier <[email protected]> libraries/framework/Symfony/Component/Yaml/Dumper.php: * @author Fabien Potencier <[email protected]> libraries/framework/Symfony/Component/Yaml/Inline.php: * @author Fabien Potencier <[email protected]> libraries/framework/Symfony/Component/Yaml/Exception/DumpException.php: * @author Fabien Potencier <[email protected]> libraries/framework/Symfony/Component/Yaml/Exception/ParseException.php: * @author Fabien Potencier <[email protected]> libraries/framework/Symfony/Component/Yaml/Exception/ExceptionInterface.php: * @author Fabien Potencier <[email protected]> 

<[email protected]>

This tag:
* @author <[email protected]>
has been used a total of 5 times within the following files:

libraries/phputf8/utils/unicode.php:* @author <[email protected]> libraries/phputf8/utils/unicode.php:* @author <[email protected]> libraries/phputf8/utils/bad.php:* @author <[email protected]> libraries/phputf8/utils/validation.php:* @author <[email protected]> libraries/joomla/string/string.php:   * @author  <[email protected]> 

Andy Prevost

This tag:
* @author Andy Prevost
has been used a total of 4 times within the following files:

libraries/phpmailer/phpmailer.php: * @author Andy Prevost libraries/phpmailer/smtp.php: * @author Andy Prevost libraries/phpmailer/pop3.php: * @author Andy Prevost libraries/phpmailer/pop3.php: * @author Andy Prevost 

Chris Smith<[email protected]>

This tag:
* @author Chris Smith<[email protected]>
has been used a total of 4 times within the following files:

libraries/phputf8/utils/position.php:* @author Chris Smith<[email protected]> libraries/phputf8/utils/position.php:* @author Chris Smith<[email protected]> libraries/phputf8/utils/position.php:* @author Chris Smith<[email protected]> libraries/phputf8/native/core.php:* @author Chris Smith<[email protected]> 

Jim Jagielski

This tag:
* @author Jim Jagielski
has been used a total of 4 times within the following files:

libraries/phpmailer/phpmailer.php: * @author Jim Jagielski libraries/phpmailer/smtp.php: * @author Jim Jagielski libraries/phpmailer/pop3.php: * @author Jim Jagielski libraries/phpmailer/pop3.php: * @author Jim Jagielski 

Harald Kirschner <mail [at] digitarald.de>

This tag:
* @author Harald Kirschner <mail [at] digitarald.de>
has been used a total of 3 times within the following files:

media/system/css/modal.css: * @author    Harald Kirschner <mail [at] digitarald.de> media/system/js/modal.js: @author    Harald Kirschner <mail [at] digitarald.de> media/system/js/modal-uncompressed.js: * @author    Harald Kirschner <mail [at] digitarald.de> 

Rouven We�ling <me [at] rouvenwessling.de>

This tag:
* @author Rouven We�ling <me [at] rouvenwessling.de>
has been used a total of 3 times within the following files:

media/system/css/modal.css: * @author    Rouven We�ling <me [at] rouvenwessling.de> media/system/js/modal.js: @author    Rouven We�ling <me [at] rouvenwessling.de> media/system/js/modal-uncompressed.js: * @author    Rouven We�ling <me [at] rouvenwessling.de> 

Matthias Sommerfeld <[email protected]>

This tag:
* @author Matthias Sommerfeld <[email protected]>
has been used a total of 3 times within the following files:

libraries/simplepie/idn/idna_convert.class.php: * @author  Matthias Sommerfeld <[email protected]> libraries/simplepie/idn/idna_convert.class.php:* @author  Matthias Sommerfeld <[email protected]> libraries/idna_convert/idna_convert.class.php: * @author  Matthias Sommerfeld <[email protected]> 

Marcus Bointon

This tag:
* @author Marcus Bointon
has been used a total of 3 times within the following files:

libraries/phpmailer/phpmailer.php: * @author Marcus Bointon libraries/phpmailer/smtp.php: * @author Marcus Bointon libraries/phpmailer/pop3.php: * @author Marcus Bointon 

Geoffrey Sneddon

This tag:
* @author Geoffrey Sneddon
has been used a total of 2 times within the following files:

libraries/simplepie/simplepie.php: * @author Geoffrey Sneddon libraries/simplepie/simplepie.php:   * @author Geoffrey Sneddon 

Anthony Ferrara <[email protected]>

This tag:
* @author Anthony Ferrara <[email protected]>
has been used a total of 2 times within the following files:

libraries/compat/password/lib/version_test.php: * @author Anthony Ferrara <[email protected]> libraries/compat/password/lib/password.php: * @author Anthony Ferrara <[email protected]> 

Matthew Lewinski <[email protected]>

This tag:
* @author Matthew Lewinski <[email protected]>
has been used a total of 2 times within the following files:

libraries/framework/Symfony/Component/Yaml/Unescaper.php: * @author Matthew Lewinski <[email protected]> libraries/framework/Symfony/Component/Yaml/Escaper.php: * @author Matthew Lewinski <[email protected]> 

Romain Neutron <[email protected]>

This tag:
* @author Romain Neutron <[email protected]>
has been used a total of 1 times within the following files:

libraries/framework/Symfony/Component/Yaml/Exception/RuntimeException.php: * @author Romain Neutron <[email protected]> 

Jay Burrell, Systems & Networks, Mississippi State University

This tag:
* @author Jay Burrell, Systems & Networks, Mississippi State University
has been used a total of 1 times within the following files:

libraries/joomla/client/ldap.php:   * @author  Jay Burrell, Systems & Networks, Mississippi State University 

Oliver Saunders <oliver (a) osinternetservices.com>

This tag:
* @author Oliver Saunders <oliver (a) osinternetservices.com>
has been used a total of 1 times within the following files:

libraries/phputf8/str_pad.php:* @author Oliver Saunders <oliver (a) osinternetservices.com> 

Matthias Sommerfeld, <[email protected]>

This tag:
* @author Matthias Sommerfeld, <[email protected]>
has been used a total of 1 times within the following files:

libraries/idna_convert/transcode_wrapper.php: * @author Matthias Sommerfeld, <[email protected]> 

Matthias Sommerfeld <[email protected]>

This tag:
* @author Matthias Sommerfeld <[email protected]>
has been used a total of 1 times within the following files:

libraries/idna_convert/uctc.php: * @author Matthias Sommerfeld  <[email protected]> 

<chernyshevsky at hotmail dot com>

This tag:
* @author <chernyshevsky at hotmail dot com>
has been used a total of 1 times within the following files:

libraries/phputf8/native/core.php:* @author <chernyshevsky at hotmail dot com> 

elfrink at introweb dot nl

This tag:
* @author elfrink at introweb dot nl
has been used a total of 1 times within the following files:

libraries/simplepie/simplepie.php: * @author elfrink at introweb dot nl 

Nicholas

This tag:
* @author Nicholas
has been used a total of 1 times within the following files:

administrator/components/com_joomlaupdate/restore.php: * @author Nicholas 

Nicholas K. Dionysopoulos

This tag:
* @author Nicholas K. Dionysopoulos
has been used a total of 1 times within the following files:

administrator/components/com_joomlaupdate/restore.php:   * @author Nicholas K. Dionysopoulos 

Brett Stimmerman <brettstimmerman[at]gmail[dot]com>

This tag:
* @author Brett Stimmerman <brettstimmerman[at]gmail[dot]com>
has been used a total of 1 times within the following files:

administrator/components/com_joomlaupdate/restore.php: * @author      Brett Stimmerman <brettstimmerman[at]gmail[dot]com> 

Matt Knapp <mdknapp[at]gmail[dot]com>

This tag:
* @author Matt Knapp <mdknapp[at]gmail[dot]com>
has been used a total of 1 times within the following files:

administrator/components/com_joomlaupdate/restore.php: * @author      Matt Knapp <mdknapp[at]gmail[dot]com> 

Michal Migurski <[email protected]>

This tag:
* @author Michal Migurski <[email protected]>
has been used a total of 1 times within the following files:

administrator/components/com_joomlaupdate/restore.php: * @author      Michal Migurski <[email protected]> 

Chris Ryan

This tag:
* @author Chris Ryan
has been used a total of 1 times within the following files:

libraries/phpmailer/smtp.php: * @author Chris Ryan 

Richard Davey (orig) <[email protected]>

This tag:
* @author Richard Davey (orig) <[email protected]>
has been used a total of 1 times within the following files:

libraries/phpmailer/pop3.php: * @author Richard Davey (orig) <[email protected]> 

Josh Peck <jmp at joshpeck dot org>

This tag:
* @author Josh Peck <jmp at joshpeck dot org>
has been used a total of 1 times within the following files:

libraries/simplepie/simplepie.php: * @author Josh Peck <jmp at joshpeck dot org> 

nikosdion <[email protected]>

This tag:
* @author nikosdion <[email protected]>
has been used a total of 1 times within the following files:

administrator/components/com_joomlaupdate/models/default.php: * @author      nikosdion <[email protected]> 

Alexander Merz <[email protected]>

This tag:
* @author Alexander Merz <[email protected]>
has been used a total of 1 times within the following files:

libraries/simplepie/simplepie.php: * @author Alexander Merz <[email protected]> 

Ryan Parman

This tag:
* @author Ryan Parman
has been used a total of 1 times within the following files:

libraries/simplepie/simplepie.php: * @author Ryan Parman 

Geoffrey Sneddon <[email protected]>

This tag:
* @author Geoffrey Sneddon <[email protected]>
has been used a total of 1 times within the following files:

libraries/simplepie/simplepie.php: * @author Geoffrey Sneddon <[email protected]> 

Was this article helpful? Join the conversation!