Development:Frankenstyle: Difference between revisions

From MoodleDocs
Line 8: Line 8:


* The prefix is determined by the type of plugin. For example, the prefix for a module is '''mod'''.
* The prefix is determined by the type of plugin. For example, the prefix for a module is '''mod'''.
* The name is the name of the plugin. (Plugin names are always made of lower-case letters).
* The name is the name of the plugin. (Plugin names are always made of lower-case letters.)


So the frankenstyle name for the quiz module is '''mod_quiz'''.
So the frankenstyle name for the quiz module is '''mod_quiz'''.

Revision as of 13:17, 12 November 2010

'Frankenstyle' refers to the naming convention that is used to uniquely identify a Moodle plugin based on the type of plugin and its name.

Martin Dougiamas is credited with inventing the word 'frankenstyle'. (It is a great word!)

Format

Frankenstyle names have a prefix and then a name, separated by an underscore.

  • The prefix is determined by the type of plugin. For example, the prefix for a module is mod.
  • The name is the name of the plugin. (Plugin names are always made of lower-case letters.)

So the frankenstyle name for the quiz module is mod_quiz.

Plugin types

  • Module: mod_
  • Admin report: report_
  • Course report: coursereport_
  • ... (TODO - somebody else add these as they come up please)

Usages

Frankenstyle is used in:

Table names

All table names for a plugin must begin with its frankenstyle name (after the standard Moodle table prefix).

Examples: mdl_mod_quiz, mdl_mod_quiz_attempts

Capabilities

All capabilities for a plugin use the frankenstyle name, except with a / instead of a _.

Example: mod/quiz:viewattempt

Other places (TODO)

Please add more as they come up.