Add short instructions on placeholder admin page

[Kristina Hoeppner]

For upcoming Mahara 19.10: The placeholder admin page at Admin menu -> Extensions -> Plugin administration -> Blocktype configure icon /admin/extensions/plugintypeconfig.php?plugintype=blocktype needs a brief description for what admins can do on that page:

Move individual blocks to change the order in which they appear in the placeholder block that is put on a page. The numbers indicate how many times a specific block type is already in use on the site.

---

More information can go into a help file displayed via a help icon:

All block types that are possible to use on the site are displayed. You can change their order by dragging and dropping them. The order will be changed for everyone on the site.

By changing the order you can highlight often used block types or encourage people to add lesser used ones as they are higher up.

Per default, up to 4 block types are displayed when adding the placeholder block to a page. These are the most important ones. The other blocks are made visible by clicking the "Show more" button in the block configuration.

The numbers in each block type on this page indicate how many times a particular block type is already in use. Note that some block types are placed on every dashboard, profile, or group homepage. These numbers may then be higher due to being on everyone's page or every group homepage.

[Mahara Bot (dev-mahara)]

Patch for "master" branch: https://reviews.mahara.org/10381

[Steven (stevens-q)]

Commit hash: 9b51e9d6841aecf471f7a0b5538d459c4e81dead
Environment tested: Master
Browser tested: Chrome
Theme used: Raw

PRECONDITIONS:
------------------------
1) n/a

TEST STEPS:
------------------------
1) Log in as Site admin
2) Browse to <base url> /admin/extensions/plugintypeconfig.php?plugintype=blocktype
3) Verify the text under the page title is as follows: ✔
     Move individual blocks to change the order in which they appear in the placeholder block that is put on a page. The numbers indicate how many times a specific block type is already in use on the site.
4) Click the help icon to the right of the page title
5) Verify the text in the help modal is displayed as follows ✔
     All block types that are possible to use on the site are displayed. You can change their order by dragging and dropping them. The order will be changed for everyone on the site.

By changing the order you can highlight often used block types or encourage people to add lesser used ones as they are higher up.

Per default, up to 4 block types are displayed when adding the placeholder block to a page. These are the most important ones. The other blocks are made visible by clicking the "Show more" button in the block configuration.

The numbers in each block type on this page indicate how many times a particular block type is already in use. Note that some block types are placed on every dashboard, profile, or group homepage. These numbers may then be higher due to being on everyone's page or every group homepage.

Catalyst QA Approved ✔

[Mahara Bot (dev-mahara)]

Reviewed: https://reviews.mahara.org/10381
Committed: https://git.mahara.org/mahara/mahara/commit/f9a215b190ed4d4a0ee1c3b35854df094cbaecfd
Submitter: Robert Lyon (<email address hidden>)
Branch: master

commit f9a215b190ed4d4a0ee1c3b35854df094cbaecfd
Author: Lisa Seeto <email address hidden>
Date: Thu Sep 26 14:18:23 2019 +1200

Bug 1840565: Add short instructions on placeholder admin page

- add help text file pages/admin/blocktype.html
- update SECTION_PLUGINTYPE, SECTION_PLUGINNAME and SECTION_PAGE
so the help text for 'blocktype' plugin will be found
and the help icon will display near title
- made the description/instructions only show for the plugintype
blocktype page

behatnotneeded

Change-Id: I9cebcad38b94a91bd011ab0bb21c2eb8fc911a92
Signed-off-by: Lisa Seeto <email address hidden>