Linux 软件免费装
Banner图

{eac}Doojigger Readme Extension for WordPress

开发者 kevinburkholder
更新时间 2024年10月12日 20:53
PHP版本: 7.4 及以上
WordPress版本: 6.6
版权: GPLv3 or later
版权网址: 版权信息

标签

markdown github svn readme parsedown {eac}Doojigger code-highlighting

下载

1.4.0 1.4.2 1.0.6 1.0.7 1.2.0 1.4.1 1.4.3 1.2.5 1.1.0 1.1.1 1.2.2 1.2.3 1.2.4 1.2.6 1.3.0

详情介绍:

{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/) [eacReadme wpsvn='/slugname/trunk/readme.txt'] # load file from WordPress SVN repository [eacReadme github='/owner/repository/main/readme.txt'] # load file from github repository 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 Or load the entire file as a single code block... [eacReadme theme='/themefolder/functions.php']Code File[/eacReadme] 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] Get a file as a code block... [eacReadme theme='/my-child-theme/functions.js' lang='js']Code File[/eacReadme] [eacReadme theme='/my-child-theme/style.css' lang='css']Code File[/eacReadme] Other Options Change the default cache time-to-live by adding to wp-config.php: define('EAC_README_CACHE_LIFETIME',$seconds); # default: 1-day (DAY_IN_SECONDS). Override the default cache time-to-live [eacReadme ttl=$seconds ...] # minimum: 1-minute (MINUTE_IN_SECONDS). Set the default GitHub access token (for private repositories): define('GITHUB_ACCESS_TOKEN',$token); Set/override the GitHub access token [eacReadme token=$token ...] 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', ]; Readme Format {eac}Readme expects a well-formed readme.txt file that follows the WordPress readme file standard... === title === header: value header: value short Description == section == sub-section ...but supports some extensions to that standard: ``` === title === header: value header: value short Description == section == sub-section ```
Note: these extensions are not supported by the WordPress Plugin Repository.
{eac}Readme supports standard markdown (readme.md) formatting for section identification. Output HTML When retrieving the header block with ... [eacReadme]All Headers[/eacReadme] or \eacParseReadme::getAllHeaders() Or when retrieving all sections with ... [eacReadme]All Sections[/eacReadme] or \eacParseReadme::getAllSections() Or when retrieving the entire document with ... [eacReadme]Document[/eacReadme] or \eacParseReadme::getDocument() Additional html tags and classes are added, including wrapping blocks within a <details> tags, adding readme-* class names, and adding <a> anchor links. WordPress Actions 3rd-party actors may load and use the parser class included in {eac}Readme... do_action('eacReadme_load_parser'); // loads \eacParseReadme static class if (class_exists('\eacParseReadme')) { \eacParseReadme::loadFile($readme,$context); $html_document = \eacParseReadme::getDocument(); $title = \eacParseReadme::getTitle(); $version = \eacParseReadme::getVersion(); $donations = \eacParseReadme::getHeader('donate_link'); $description = \eacParseReadme::getSection('description'); }

安装:

{eac}Doojigger Readme Extension is an extension plugin to and requires installation and registration of {eac}Doojigger. Automatic Plugin Installation This plugin is available from the WordPress Plugin Repository and can be installed from the WordPress Dashboard » Plugins » Add New page. Search for 'EarthAsylum', click the plugin's [Install] button and, 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. Click the [Upload Plugin] button, then select 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.

屏幕截图:

  • Readme Help

升级注意事项:

1.2.0 Requires {eac}Doojigger version 2.0+

其他记录:

Additional Information

更新日志:

Version 1.4.3 – October 12, 2024 Version 1.4.2 – April 4, 2024 Version 1.4.1 – March 1, 2024 Version 1.4.0 – February 9, 2024 Version 1.3.0 – January 31, 2024 Version 1.2.6 – January 24, 2024 Version 1.2.5 – December 8, 2023 Version 1.2.4 – December 4, 2023 Version 1.2.3 – August 30, 2023 Version 1.2.2 – June 6, 2023 Version 1.2.1 – April 22, 2023 Version 1.2.0 – November 16, 2022 Version 1.1.1 – September 25, 2022 Version 1.1.0 – September 7, 2022 Version 1.0.7 – August 28, 2022 Version 1.0.6 – July 12, 2022 Version 1.0.5 – June 22, 2022 Version 1.0.4 – June 9, 2022 Version 1.0.3 – May 12, 2022 Version 1.0.2 – May 10, 2022 Version 1.0.1 – April 28, 2022 Version 1.0.0 – February 26, 2022