.. include:: /shortcuts.rstext

.. index::
   pair: Administration; Development
   single: Site administrator; Development

.. _development:

|new in Mahara 21.10| Development
-------------------------------------------

*Administration menu → Development*

.. note::
   *Development* is only accessible by site administrators.

This administration section includes tools for developers to make them easily accessible.

.. index::
   single: Development; Behat steps

.. _behat_steps:

|new in Mahara 21.10| Behat steps
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

*Administration menu → Development → Behat steps*

.. figure:: /images/administration/behat_steps.*
   :alt: Display Behat steps that you can use in your own tests

   Display Behat steps that you can use in your own tests

Mahara comes with a `Behat automation test suite <https://wiki.mahara.org/wiki/Testing/Behat_Testing>`_ that makes it possible to automate a lot of manual testing.

:index:`On <single: New in Mahara 21.10; Behat step register>` this page you see the Behat steps that you can use in Mahara out of the box. They are listed as a reference so you can see how they are being used.

#. A warning is displayed if the permissions on the Behat folder in your dataroot are not correct and the steps can't be read. Some steps are always displayed, but not the majority of them unless you have the permissions correct.
#. Click the text of a step or the chevron |menu open| to see all instances where this step is used.
#. The question mark indicates that there can be different text.
#. Click the file name to see the actual text used in this particular file.
#. The line and the step are displayed.

.. index::
   single: Development; Components library

.. _components_library:

|new in Mahara 21.10| Components library
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

*Administration menu → Development → Components library*

.. figure:: /images/administration/components_library.*
   :alt: List of all third-party plugins in Mahara

   List of all third-party plugins in Mahara

:index:`Mahara <single: New in Mahara 21.10; Components library>` uses a number of third-party plugins that deliver JavaScript, filtering, templating, and many more. On this page you see them all listed along with their version number in this particular version of Mahara and the path to their project site. That information is taken from the 'Readme.mahara' files available in each plugin in the code base.

#. **Plugin**: The name of the plugin.
#. **Path**: Where you can find the code in the Mahara code base.
#. **Version**: Current version number of this plugin.
#. **URL**: Official URL of the plugin where you can find out more about it.

.. index::
   single: Development; Style guide

.. _styleguide:

Style guide
~~~~~~~~~~~~~~~~~~~~

*Administration menu → Development → Style guide*

The style guide is a reference guide for developers. It describes the components that are used in Mahara and provides their CSS markup so you can check if you have styled everything consistently with the rest of the environment.

If you want to check what the individual components look like in a different theme, switch the site theme and refresh the style guide.

.. note::
   Currently, the style guide is only available in English, and more elements will be added with time.

.. figure:: /images/administration/styleguide.*
   :alt: The style guide

   The style guide

#. Navigation to reach the various different component groups within Mahara.
#. Title and short description of the component.
#. What the component looks like.
#. The code that is needed to produce the component.

   .. note::
      This often has to be adjusted somewhat to account for different text on a button or different options. This is the code of the example.

#. Click the *Copy* button |copy| to copy the code to the clipboard.