{"id":174339,"date":"2023-05-12T21:45:07","date_gmt":"2023-05-12T21:45:07","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/eacsoftwareregistry-software-taxonomy\/"},"modified":"2025-07-21T21:40:41","modified_gmt":"2025-07-21T21:40:41","slug":"eacsoftwareregistry-software-taxonomy","status":"publish","type":"plugin","link":"https:\/\/scn.wordpress.org\/plugins\/eacsoftwareregistry-software-taxonomy\/","author":20183118,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"2.0.12","stable_tag":"2.0.12","tested":"6.8.5","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"{eac}SoftwareRegistry Software Taxonomy","header_author":"EarthAsylum Consulting","header_description":"Software Registration Server Software Product Taxonomy - Define software products to be registered with {eac}Software Registration Server.","assets_banners_color":"b4c5a5","last_updated":"2025-07-21 21:40:41","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/github.com\/sponsors\/EarthAsylum","header_plugin_uri":"https:\/\/swregistry.earthasylum.com\/software-taxonomy\/","header_author_uri":"http:\/\/www.earthasylum.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":2263,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","changelog"],"tags":{"1.1.0":{"tag":"1.1.0","author":"kevinburkholder","date":"2023-11-01 21:54:56"},"2.0.0":{"tag":"2.0.0","author":"kevinburkholder","date":"2024-02-22 15:35:57"},"2.0.1":{"tag":"2.0.1","author":"kevinburkholder","date":"2024-02-23 23:43:21"},"2.0.10":{"tag":"2.0.10","author":"kevinburkholder","date":"2025-03-13 14:15:06"},"2.0.12":{"tag":"2.0.12","author":"kevinburkholder","date":"2025-07-21 21:40:41"},"2.0.2":{"tag":"2.0.2","author":"kevinburkholder","date":"2024-02-25 21:57:13"},"2.0.3":{"tag":"2.0.3","author":"kevinburkholder","date":"2024-03-01 16:54:00"},"2.0.4":{"tag":"2.0.4","author":"kevinburkholder","date":"2024-04-05 14:44:32"},"2.0.5":{"tag":"2.0.5","author":"kevinburkholder","date":"2024-04-16 02:07:47"},"2.0.7":{"tag":"2.0.7","author":"kevinburkholder","date":"2024-05-09 01:44:23"},"2.0.8":{"tag":"2.0.8","author":"kevinburkholder","date":"2024-11-23 17:11:11"},"2.0.9":{"tag":"2.0.9","author":"kevinburkholder","date":"2024-11-24 04:29:44"}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":2911812,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":2911812,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.jpg":{"filename":"banner-1544x500.jpg","revision":2911812,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":2911812,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.1.0","2.0.0","2.0.1","2.0.10","2.0.12","2.0.2","2.0.3","2.0.4","2.0.5","2.0.7","2.0.8","2.0.9"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3092464,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3092464,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3092464,"resolution":"3","location":"assets","locale":""},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3092464,"resolution":"4","location":"assets","locale":""},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3092464,"resolution":"5","location":"assets","locale":""},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3092464,"resolution":"6","location":"assets","locale":""}},"screenshots":{"1":"<p>Software Registry \u2192 Software Products\n<\/p>","2":"<p>Software Registry \u2192 Software Products \u2192 {product} \u2192 Registrar Contact\n<\/p>","3":"<p>Software Registry \u2192 Software Products \u2192 {product} \u2192 Registration Defaults\n<\/p>","4":"<p>Software Registry \u2192 Software Products \u2192 {product} \u2192 Client Notification\n<\/p>","5":"<p>Software Registry \u2192 Software Products \u2192 {product} \u2192 License Limitations\n<\/p>","6":"<p>Software Registry \u2192 Software Products \u2192 {product} \u2192 Github Hosting\n<\/p>"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[224617,26437,220440,211904,211995],"plugin_category":[],"plugin_contributors":[211905],"plugin_business_model":[],"class_list":["post-174339","plugin","type-plugin","status-publish","hentry","plugin_tags-github-hosting","plugin_tags-software-license","plugin_tags-software-product","plugin_tags-software-registration","plugin_tags-software-registry","plugin_contributors-kevinburkholder","plugin_committers-kevinburkholder"],"banners":{"banner":"https:\/\/ps.w.org\/eacsoftwareregistry-software-taxonomy\/assets\/banner-772x250.jpg?rev=2911812","banner_2x":"https:\/\/ps.w.org\/eacsoftwareregistry-software-taxonomy\/assets\/banner-1544x500.jpg?rev=2911812","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/eacsoftwareregistry-software-taxonomy\/assets\/icon-128x128.png?rev=2911812","icon_2x":"https:\/\/ps.w.org\/eacsoftwareregistry-software-taxonomy\/assets\/icon-256x256.png?rev=2911812","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/eacsoftwareregistry-software-taxonomy\/assets\/screenshot-1.png?rev=3092464","caption":"<p>Software Registry \u2192 Software Products\n<\/p>"},{"src":"https:\/\/ps.w.org\/eacsoftwareregistry-software-taxonomy\/assets\/screenshot-2.png?rev=3092464","caption":"<p>Software Registry \u2192 Software Products \u2192 {product} \u2192 Registrar Contact\n<\/p>"},{"src":"https:\/\/ps.w.org\/eacsoftwareregistry-software-taxonomy\/assets\/screenshot-3.png?rev=3092464","caption":"<p>Software Registry \u2192 Software Products \u2192 {product} \u2192 Registration Defaults\n<\/p>"},{"src":"https:\/\/ps.w.org\/eacsoftwareregistry-software-taxonomy\/assets\/screenshot-4.png?rev=3092464","caption":"<p>Software Registry \u2192 Software Products \u2192 {product} \u2192 Client Notification\n<\/p>"},{"src":"https:\/\/ps.w.org\/eacsoftwareregistry-software-taxonomy\/assets\/screenshot-5.png?rev=3092464","caption":"<p>Software Registry \u2192 Software Products \u2192 {product} \u2192 License Limitations\n<\/p>"},{"src":"https:\/\/ps.w.org\/eacsoftwareregistry-software-taxonomy\/assets\/screenshot-6.png?rev=3092464","caption":"<p>Software Registry \u2192 Software Products \u2192 {product} \u2192 Github Hosting\n<\/p>"}],"raw_content":"<!--section=description-->\n<p><strong>{eac}SoftwareRegistry Software Taxonomy<\/strong> is an extension plugin to <a href=\"https:\/\/swregistry.earthasylum.com\/software-registration-server\/\">{eac}SoftwareRegistry Software Registration Server<\/a>.<\/p>\n\n<p>Now with <a href=\"https:\/\/swregistry.earthasylum.com\/github-hosting\/\">plugin hosting on Github<\/a> to provide complete, automated plugin information and updates in WordPress.<\/p>\n\n<p><strong>{eac}SoftwareRegistry Software Taxonomy<\/strong> is a simple plugin extension that allows you to set and override {eac}SoftwareRegistry options for specific software products. It both defines the software product as well as the server parameters used when that product is registered via the software registration application program interface.<\/p>\n\n<p>When an API request is received by the registry server, the <code>registry_product<\/code> is matched to the software taxonomy slug. When a match is found, the parameters entered in the software taxonomy meta data are used to override the registry server default parameters.<\/p>\n\n<h4>Options set on a per-product basis by this extension<\/h4>\n\n<ul>\n<li><p><em>Software Product<\/em><\/p>\n\n<ul>\n<li><em>Registry Title<\/em>            - The Software Product display name<\/li>\n<li><em>Registry Description<\/em>      - The Software Product Description<\/li>\n<\/ul><\/li>\n<li><p><em>Registrar Contact<\/em> (override existing global options in {eac}SoftwareRegistry)<\/p>\n\n<ul>\n<li><em>Registrar Name<\/em>            - Sending client email from this name<\/li>\n<li><em>Registrar Telephone<\/em>       - Include telephone in client notifications<\/li>\n<li><em>Registrar Support Email<\/em>   - Include support email address in client notifications<\/li>\n<li><em>Registrar Web Address<\/em>     - Include web address in client notifications<\/li>\n<\/ul><\/li>\n<li><p><em>Registration Defaults<\/em> (override existing global options in {eac}SoftwareRegistry)<\/p>\n\n<ul>\n<li><em>Default Status<\/em>            - The default status to assign to newly created registrations<\/li>\n<li><em>Default Initial Term<\/em>      - The initial term when creating a new registration (pending or trial)<\/li>\n<li><em>Default Full Term<\/em>         - The full term when activating a registration<\/li>\n<li><em>Default License<\/em>           - The default license level (L1-L5, LD) to assign to newly created registrations<\/li>\n<\/ul><\/li>\n<li><p><em>Client Notification<\/em> (Customize the email message and API response notifications sent to the client)<\/p>\n\n<ul>\n<li><em>Client Email Message<\/em>      - Message sent to client on creation, activation or update of registration.<\/li>\n<li><em>Client API Message<\/em>        - Short message included with all API responses.<\/li>\n<li><em>Client Success Notice<\/em>     - Success notification sent via API response.<\/li>\n<li><em>Client Error Notice<\/em>       - Error notification sent via API response.<\/li>\n<\/ul><\/li>\n<li><p><em>License Limitations<\/em><\/p>\n\n<ul>\n<li><em>see below<\/em><\/li>\n<\/ul><\/li>\n<li><p><em>GitHub Hosting<\/em><\/p>\n\n<ul>\n<li><em>WordPress Plugin Slug<\/em>     - The {directory}\/{plugin.php} slug of the WordPress plugin.<\/li>\n<li><em>GitHub Repository<\/em>         - The {owner}\/{repository} id of the github repository.<\/li>\n<li><em>Repository Source<\/em>         - Select which source to use from the repository (branch, release).<\/li>\n<li><em>Tag Name<\/em>                  - (Optional) Specific release or branch tag name (or id).<\/li>\n<li><em>Path to readme.txt<\/em>        - Pathname within the repository to the readme.txt file.\nIf blank, the json file will be generated from information available in the GitHub repository.<\/li>\n<li><em>GitHub Access Token<\/em>       - Your GitHub personal access token, Increases the github rate limit and is required for private repositories.<\/li>\n<li><em>Plugin URLs<\/em>               - Displays the URL(s) you will need for your plugin file and readme.txt file.<\/li>\n<\/ul><\/li>\n<\/ul>\n\n<p><em>License Limitations<\/em><\/p>\n\n<p>Based on the license level assigned to a registration, we can limit the optional values in the registration API (count, variations, options, domains &amp; sites). This allows APIs (possibly from multiple sources) to register any\/all values for these options while filtering on the registration server, providing an effective (albeit rudimentary) licensing validation.<\/p>\n\n<p>For each license level ( L1=Lite, L2=Basic, L3=Standard, L4=Professional, L5=Enterprise, LD=Developer ) you may set a limit for count, variations, options, domains, and sites.<\/p>\n\n<ul>\n<li><em>count<\/em>        - Number of licenses (users\/seats\/devices)<\/li>\n<li><em>variations<\/em>   - List of custom name\/value pairs<\/li>\n<li><em>options<\/em>      - List of custom registry options<\/li>\n<li><em>domains<\/em>      - List of valid\/registered domains<\/li>\n<li><em>sites<\/em>        - List of valid\/registered sites\/uris<\/li>\n<\/ul>\n\n<p>For count, the value passed through the API is limited to a maximum value.\nFor variations, options, domains, and sites, the arrays passed through the API are sliced to a maximum number of elements.<\/p>\n\n<h4>GitHub Hosting<\/h4>\n\n<blockquote>\n  <p>&#042; GitHub hosting requires installation of the <a href=\"https:\/\/wordpress.org\/plugins\/eacreadme\/\">{eac}Readme plugin<\/a> in order to process readme.txt files.<\/p>\n<\/blockquote>\n\n<p>Wether you're using software registration or not, you can use Github Hosting to manage your software releases and provide automated updates for your WordPress plugins.<\/p>\n\n<p>New in version 2.0, these options allow for the \"self-hosting\" of WordPress plugins on GitHub in a way similar to and meeting the requirements of the <a href=\"https:\/\/wordpress.org\/plugins\/eacsoftwareregistry-software-taxonomy\/\">WordPress plugin repository<\/a>.<\/p>\n\n<p>More details may be found in the included <a href=\"https:\/\/swregistry.earthasylum.com\/github-hosting\/\">readme_github.md<\/a> file.<\/p>\n\n<h4>See Also<\/h4>\n\n<ul>\n<li><p><a href=\"https:\/\/swregistry.earthasylum.com\/software-registration-server\/\">{eac}SoftwareRegistry \u2013 Software Registration Server<\/a><\/p><\/li>\n<li><p><a href=\"https:\/\/swregistry.earthasylum.com\/software-registry-sdk\/\">Implementing the Software Registry SDK<\/a><\/p><\/li>\n<\/ul>\n\n<h3>Copyright<\/h3>\n\n<h4>Copyright \u00a9 2019-2025, EarthAsylum Consulting, distributed under the terms of the GNU GPL.<\/h4>\n\n<p>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.<\/p>\n\n<p>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.<\/p>\n\n<p>You should receive a copy of the GNU General Public License along with this program. If not, see <a href=\"https:\/\/www.gnu.org\/licenses\/\">https:\/\/www.gnu.org\/licenses\/<\/a>.<\/p>\n\n<!--section=installation-->\n<p><strong>{eac}SoftwareRegistry Software Taxonomy<\/strong> is an extension plugin to and requires installation and registration of <a href=\"https:\/\/swregistry.earthasylum.com\/\">{eac}SoftwareRegistry<\/a>.<\/p>\n\n<h4>Automatic Plugin Installation<\/h4>\n\n<p>This plugin is available from the <a href=\"https:\/\/wordpress.org\/plugins\/search\/earthasylum\/\">WordPress Plugin Repository<\/a> and can be installed from the WordPress Dashboard \u00bb <em>Plugins<\/em> \u00bb <em>Add New<\/em> page. Search for 'EarthAsylum', click the plugin's [Install] button and, once installed, click [Activate].<\/p>\n\n<p>See <a href=\"https:\/\/wordpress.org\/support\/article\/managing-plugins\/#automatic-plugin-installation-1\">Managing Plugins -&gt; Automatic Plugin Installation<\/a><\/p>\n\n<h4>Upload via WordPress Dashboard<\/h4>\n\n<p>Installation of this plugin can be managed from the WordPress Dashboard \u00bb <em>Plugins<\/em> \u00bb <em>Add New<\/em> page. Click the [Upload Plugin] button, then select the eacsoftwareregistry-software-taxonomy.zip file from your computer.<\/p>\n\n<p>See <a href=\"https:\/\/wordpress.org\/support\/article\/managing-plugins\/#upload-via-wordpress-admin\">Managing Plugins -&gt; Upload via WordPress Admin<\/a><\/p>\n\n<h4>Manual Plugin Installation<\/h4>\n\n<p>You can install the plugin manually by extracting the eacsoftwareregistry-software-taxonomy.zip file and uploading the 'eacsoftwareregistry-software-taxonomy' folder to the 'wp-content\/plugins' folder on your WordPress server.<\/p>\n\n<p>See <a href=\"https:\/\/wordpress.org\/support\/article\/managing-plugins\/#manual-plugin-installation-1\">Managing Plugins -&gt; Manual Plugin Installation<\/a><\/p>\n\n<h4>Settings<\/h4>\n\n<p>Taxonomy settings available from this extension will be seen in the <em>Software Registry \u2192 Software Products<\/em> menu.<\/p>\n\n<!--section=changelog-->\n<h4>Version 2.0.12 \u2013 July 21, 2025<\/h4>\n\n<ul>\n<li>Added additional registrar option filters.\n\n<ul>\n<li>'registrar_status', 'registrar_term', 'registrar_fullterm', 'registrar_license'<\/li>\n<\/ul><\/li>\n<\/ul>\n\n<h4>Version 2.0.11 \u2013 April 19, 2025<\/h4>\n\n<ul>\n<li>Compatible with WordPress 6.8+<\/li>\n<\/ul>\n\n<h4>Version 2.0.10 \u2013 March 10, 2025<\/h4>\n\n<ul>\n<li>Fix <code>PHP Warning:  Undefined array key<\/code> in taxonomy extension.<\/li>\n<\/ul>\n\n<h4>Version 2.0.9 \u2013 November 23, 2024<\/h4>\n\n<ul>\n<li>Added 'client_api_supplemental' field and filter to pass supplemental html to client via api response.<\/li>\n<li>Change handling of github hosting log file by appending rather than read\/write resulting in change to format.<\/li>\n<li>Compatible with WordPress 6.7.<\/li>\n<\/ul>\n\n<h4>Version 2.0.8 \u2013 May 24, 2024<\/h4>\n\n<ul>\n<li>Fix update object upgrade_info not set.<\/li>\n<\/ul>\n\n<h4>Version 2.0.7 \u2013 April 25, 2024<\/h4>\n\n<ul>\n<li>Minor layout changes\/fixes.<\/li>\n<li>Fixed version discrepancy.<\/li>\n<\/ul>\n\n<h4>Version 2.0.6 \u2013 April 19, 2024<\/h4>\n\n<ul>\n<li>Fixed default return of get_software_options() method.<\/li>\n<\/ul>\n\n<h4>Version 2.0.5 \u2013 April 15, 2024<\/h4>\n\n<ul>\n<li>Added 'client_email_footer' option and filter to add optional footer to client email notifications.<\/li>\n<\/ul>\n\n<h4>Version 2.0.4 \u2013 March 8, 2024<\/h4>\n\n<ul>\n<li>Changed route argument names from 'route_<em>' to 'update_<\/em>'.<\/li>\n<li>Changed selection values from 'latest_release' or 'default_branch' to 'release' or 'branch'.<\/li>\n<li>Allow specifying release id (or tag) or branch name.\n\n<ul>\n<li>defaults to 'latest' release or 'default' branch.<\/li>\n<\/ul><\/li>\n<li>Specific url: <code>\/{release|branch}\/{plugin_name}.json?update_id={tag|id}<\/code> overrides set options.<\/li>\n<\/ul>\n\n<h4>Version 2.0.3 \u2013 March 1, 2024<\/h4>\n\n<ul>\n<li>Fixed error getting .distignore file from zip archive.<\/li>\n<li>Include owner in default contributors.<\/li>\n<li>Use GITHUB_ACCESS_TOKEN if defined.<\/li>\n<\/ul>\n\n<h4>Version 2.0.2 \u2013 February 25, 2024<\/h4>\n\n<ul>\n<li>Use plugin name (plugin), rather than slug (plugin\/plugin.php) in JSON.<\/li>\n<li>Some restructuring of code.<\/li>\n<li>Set main plugin version correctly.<\/li>\n<li>Allow full name source (latest_release|default_branch) as well as abbreviated (release|branch).<\/li>\n<li>Changed source 'any' to 'either'.<\/li>\n<li>Change user-agent in github api.<\/li>\n<\/ul>\n\n<h4>Version 2.0.1 \u2013 February 23, 2024<\/h4>\n\n<ul>\n<li>Added 'slug' to json array.<\/li>\n<li>Support 'svg' image type if present.<\/li>\n<\/ul>\n\n<h4>Version 2.0.0 \u2013 February 22, 2024<\/h4>\n\n<ul>\n<li>Added GitHub hosting for WordPress plugins.<\/li>\n<\/ul>\n\n<h4>Version 1.1.1 \u2013 October 31, 2023<\/h4>\n\n<ul>\n<li>Prevent direct load of include files.<\/li>\n<\/ul>\n\n<h4>Version 1.1.0 \u2013 May 9, 2023<\/h4>\n\n<ul>\n<li>Added client notification messages.<\/li>\n<li>Reformatted license limitations tab.<\/li>\n<li>Added contextual help.<\/li>\n<\/ul>\n\n<h4>Version 1.0.0 \u2013 April 11, 2023<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<\/ul>","raw_excerpt":"Software Product Taxonomy - Customize {eac}SoftwareRegistry with options, licensing, client messaging, and Github hosting for each software product.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/174339","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=174339"}],"author":[{"embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/kevinburkholder"}],"wp:attachment":[{"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=174339"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=174339"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=174339"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=174339"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=174339"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=174339"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}