{eac}Readme is an {eac}Doojigger extension which loads and translates a WordPress markdown 'readme.txt' file providing shortcodes to access header lines and section blocks.

Shortcode Usage

The first used shortcode must indicate the file to load...

[eacReadme file='docfolder/readme.txt']         # file is relative to the WordPress document root folder
[eacReadme content='contentfolder/readme.txt']  # content file is relative to the WordPress content folder (wp-content/)
[eacReadme plugin='pluginfolder/readme.txt']    # plugin file is relative to the WordPress plugins folder (wp-content/plugins/)
[eacReadme theme='themefolder/readme.txt']      # theme file is relative to the WordPress themes folder (wp-content/themes/)

After which, headers and sections may be pulled from that file...

[eacReadme]All Headers[/eacReadme]              # parses all header lines
[eacReadme]headerName[/eacReadme]               # gets the value of the named header line

[eacReadme]All Sections[/eacReadme]             # parses all section blocks
[eacReadme]sectionName[/eacReadme]              # parses the content of the named section block
[eacReadme]sectionName/sub-section[/eacReadme]  # parses the content of the named sub-section within section block

One shortcode can do it all...

[eacReadme plugin='pluginfolder/readme.txt']Document[/eacReadme]    # loads the file and parses the entire document

Shortcode Examples

Get header values...

[eacReadme]Contributors[/eacReadme]
[eacReadme]Donate link[/eacReadme]
[eacReadme]Requires at least[/eacReadme]
[eacReadme]Stable tag[/eacReadme]

Get unnamed segments...

[eacReadme]Title[/eacReadme]                    # gets the '=== plugin name ===' line (before headers)
[eacReadme]Short Description[/eacReadme]        # gets the short description (between headers and first section block)

Get section blocks...

[eacReadme]Description[/eacReadme]
[eacReadme]Installation[/eacReadme]
[eacReadme]Screenshots[/eacReadme]
[eacReadme]Changelog[/eacReadme]

Get multiple blocks and/or sub-sections...

[eacReadme plugin='eacReadme/readme.txt']Short Description,Description[/eacReadme]
[eacReadme plugin='eacReadme/readme.txt']Short Description,Description/Shortcode Examples[/eacReadme]

Other Options

Override option to parse markdown when retrieving a segment

[eacReadme parse='true|false' ...]

Set class='language-*' on code blocks

[eacReadme lang='php|js|css|html' ...]

Translating Header/Section Names

Translate header/section names when retrieving All Headers, All Sections, or Document

[eacReadme translate='name=newname,...']
[eacReadme translate='Requires at least=Requires WordPress Version,Screenshots=Screen Shots']

Erase default translation table

[eacReadme translate='no|none|false']

Default translation table

[
    'Headers'               => 'Document Header',
    'Plugin URI'            => 'Homepage',
    'Stable tag'            => 'Current Version',
    'Requires at least'     => 'Requires WordPress Version',
    'Tested up to'          => 'Compatible up to',
    'Requires PHP'          => 'Requires PHP Version',
    'WC requires at least'  => 'Requires WooCommerce',
    'Requires EAC'          => 'Requires {eac}Doojigger',
    'Changelog'             => 'Change Log',
    'Screenshots'           => 'Screen Shots',
];

Automatic Plugin Installation

This plugin is available from the WordPress Plugin Directory and can be installed from the the 'Plugins' page » 'Add New' and search for 'EarthAsylum'. Click the plugin's 'Install' button. Once installed, click 'Activate'.

See Managing Plugins -> Automatic Plugin Installation

Upload via WordPress Dashboard

Installation of this plugin can be managed from the WordPress Dashboard » 'Plugins' » 'Add New' page by clicking the 'Upload Plugin' button, then selecting the eacreadme.zip file from your computer.

See Managing Plugins -> Upload via WordPress Admin

Manual Plugin Installation

You can install the plugin manually by extracting the eacreadme.zip file and uploading the 'eacreadme' folder to the 'wp-content/plugins' folder on your WordPress server.

See Managing Plugins -> Manual Plugin Installation

Settings

Once installed and activated options for this extension will show in the 'General' tab of {eac}Doojigger settings.

1. Readme Extension

• {eac}Readme is an extension plugin of and requires installation and registration of {eac}Doojigger.
• {eac}Readme uses Parsedown 1.7.4, Copyright (c) 2013-2018 Emanuil Rusev
• {eac}Readme uses Prism syntax highlighter, Copyright (c) 2012 Lea Verou

Copyright © 2019-2022, EarthAsylum Consulting, distributed under the terms of the GNU GPL.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should receive a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.

Version 1.0.6 – July 12, 2022

• Get contributor profile when getting all headers.
• Move short description before heades in getDocument().

Version 1.0.5 – June 22, 2022

• Added "{plugin}_eacReadme" filter.
• Added title attribute to nav links.

Version 1.0.4 – June 9, 2022

• Updated for {eac}Doojigger 1.1.0

Version 1.0.3 – May 12, 2022

• Added transient caching of contributor profiles.

Version 1.0.2 – May 10, 2022

• Added section name translation.

Version 1.0.1 – April 28, 2022

• Minor changes / enhancements.

Version 1.0.0 – February 26, 2022

• Initial release.