{"id":147376,"date":"2021-09-21T06:30:06","date_gmt":"2021-09-21T06:30:06","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/document-generator-for-openapi\/"},"modified":"2023-07-04T17:59:08","modified_gmt":"2023-07-04T17:59:08","slug":"document-generator-for-openapi","status":"publish","type":"plugin","link":"https:\/\/tah.wordpress.org\/plugins\/document-generator-for-openapi\/","author":20032101,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.1.0","stable_tag":"1.1.0","tested":"6.2.9","requires":"5.7","requires_php":"7.0","requires_plugins":null,"header_name":"Document Generator for OpenAPI","header_author":"Schneider & Schuetz GmbH","header_description":"OpenAPI (fka. Swagger) Document Generator for WordPress REST API","assets_banners_color":"","last_updated":"2023-07-04 17:59:08","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/www.schneiderundschuetz.com\/","header_plugin_uri":"","header_author_uri":"https:\/\/www.schneiderundschuetz.com\/","rating":0,"author_block_rating":0,"active_installs":40,"downloads":8580,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","changelog"],"tags":{"1.0.2":{"tag":"1.0.2","author":"schneiderundschuetz","date":"2021-09-21 06:51:22"},"1.1.0":{"tag":"1.1.0","author":"schneiderundschuetz","date":"2023-07-04 17:59:08"}},"upgrade_notice":[],"ratings":[],"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.2","1.1.0"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"No screenshots yet"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[1556,2209,203391,23853,153299],"plugin_category":[],"plugin_contributors":[203392],"plugin_business_model":[],"class_list":["post-147376","plugin","type-plugin","status-publish","hentry","plugin_tags-api","plugin_tags-generator","plugin_tags-openapi","plugin_tags-rest-api","plugin_tags-swagger","plugin_contributors-schneiderundschuetz","plugin_committers-schneiderundschuetz"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/document-generator-for-openapi.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p>This plugin reads the schema definition of a given WordPress REST Api namespace and transforms it to a\nOpenAPI document. The generator itself is exposed via the WordPress REST Api with the namespace document-generator-for-openapi\/v1.<\/p>\n\n<p>There is also a built in WP-CLI Command.<\/p>\n\n<h3>Limitations<\/h3>\n\n<ul>\n<li>Beware that currently the generator is exposeed to anonymous users since the WordPress schema endpoint is also publicly \navailable. Use it at your own risk or disable the plugin after use.<\/li>\n<li>No UI for configuration yet<\/li>\n<li>Currently only version 3.1.0 of the OpenAPI specification is implemented. Swagger tools for 3.0.0 might work though.<\/li>\n<li>Extensibility with hooks needs to be improved<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Install plugin via WordPress Plugin repository or by manually copying files<\/li>\n<li>Activate the plugin<\/li>\n<li>Access the REST Api of the generator by calling \/wp-json\/document-generator-for-openapi\/v1\/document?namespace=\\&lt;NAMESPACE&#062; and your OpenAPI document will be returned.<\/li>\n<li>Or use the integrated WP-CLI command wp openapi-generator export-file<\/li>\n<\/ol>\n\n<!--section=changelog-->\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Added WP-CLI command to export OpenAPI document via CLI (Thanks to @vnmedeiros - Vin\u00edcius Nunes Medeiros)<\/li>\n<\/ul>\n\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Added missing files for WordPress plugin repository<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Changed name of plugin from openapi-generator to document-generator-for-openapi<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<\/ul>","raw_excerpt":"OpenAPI (fka. Swagger) Document Generator for WordPress REST API","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/147376","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=147376"}],"author":[{"embeddable":true,"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/schneiderundschuetz"}],"wp:attachment":[{"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=147376"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=147376"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=147376"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=147376"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=147376"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=147376"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}