{"id":19860873,"url":"https://github.com/semantic-release/wordpress","last_synced_at":"2025-06-11T02:38:23.372Z","repository":{"id":185329012,"uuid":"672883048","full_name":"semantic-release/wordpress","owner":"semantic-release","description":"🐶 Semantic Release plugin for packaging up WordPress plugins / themes","archived":false,"fork":false,"pushed_at":"2025-05-29T22:52:01.000Z","size":1866,"stargazers_count":10,"open_issues_count":12,"forks_count":4,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-05-29T23:33:01.572Z","etag":null,"topics":["publish","semantic-release","version","wordpress","wordpress-deployment","wordpress-plugin-development","wordpress-theme-development"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/semantic-release.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-07-31T11:36:46.000Z","updated_at":"2025-03-29T16:17:27.000Z","dependencies_parsed_at":"2024-02-26T20:27:36.157Z","dependency_job_id":"5f0c6591-4ade-40fa-83fd-1a456523d46e","html_url":"https://github.com/semantic-release/wordpress","commit_stats":{"total_commits":290,"total_committers":5,"mean_commits":58.0,"dds":0.2931034482758621,"last_synced_commit":"938a22a0793fd8ecb5502b10128dd77291de3456"},"previous_names":["oblakstudio/semantic-release-wp-plugin","semantic-release/wordpress"],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/semantic-release%2Fwordpress","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/semantic-release%2Fwordpress/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/semantic-release%2Fwordpress/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/semantic-release%2Fwordpress/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/semantic-release","download_url":"https://codeload.github.com/semantic-release/wordpress/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/semantic-release%2Fwordpress/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":257603205,"owners_count":22571509,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["publish","semantic-release","version","wordpress","wordpress-deployment","wordpress-plugin-development","wordpress-theme-development"],"created_at":"2024-11-12T15:07:26.952Z","updated_at":"2025-06-11T02:38:23.335Z","avatar_url":"https://github.com/semantic-release.png","language":"TypeScript","readme":"# @semantic-release/wordpress\n\n[**semantic-release**](https://github.com/semantic-release/semantic-release) plugin to create a zip file for a [WordPress](https://wordpress.org) plugin or theme.\n\n![node-current (scoped)](https://img.shields.io/node/v/%40semantic-release/wordpress)\n[![NPM Version (with dist tag)](https://img.shields.io/npm/v/%40semantic-release%2Fwordpress/latest)](https://www.npmjs.com/package/@semantic-release/wordpress)\n[![NPM Version (with dist tag)](https://img.shields.io/npm/v/%40semantic-release%2Fwordpress/beta?color=d00)](https://www.npmjs.com/package/@semantic-release/)\n[![Release](https://github.com/semantic-release/wordpress/actions/workflows/release.yml/badge.svg)](https://github.com/semantic-release/wordpress/actions/workflows/release.yml)\n![Scrutinizer coverage (GitHub/BitBucket)](https://img.shields.io/scrutinizer/coverage/g/oblakstudio/semantic-release-wp-plugin/master)\n\n| Step               | Description                                                                                                     |\n|--------------------|-----------------------------------------------------------------------------------------------------------------|\n| `verifyConditions` | Verify if the theme / plugin is valid. Check that the necessary files exist and if they contain needed metadata |\n| `prepare`          | Copy the theme / plugins files and optionally prepare the asset bundle                                          |\n| `publish`          | Create a zip file for the theme / plugin, and optionally zip the assets                                         |\n| `success`          | Clean up the intermediate files                                                                                 |\n\n## Install\n\n```bash\n$ npm install -D @semantic-release/wordpress\n```\n## Usage\n\nThe plugin can be configured in the [**semantic-release** configuration file](https://github.com/semantic-release/semantic-release/blob/master/docs/usage/configuration.md#configuration):\n\n```json\n{\n  \"plugins\": [\n    \"@semantic-release/commit-analyzer\",\n    \"@semantic-release/release-notes-generator\",\n    [\"@semantic-release/wordpress\", {\n      \"type\": \"plugin\",\n      \"slug\" : \"my-plugin\",\n      \"withAssets\": true,\n      \"withReadme\": true,\n      \"withVersionFile\": true,\n    }]\n  ]\n}\n```\n\nWith this example, for each release, the plugin will:\n  * Verify that the plugin is valid\n  * Create a zip file for the plugin (/tmp/wp-release/my-plugin.zip)\n  * Create a zip file for the assets (/tmp/wp-release/assets.zip)\n  * Copy the readme.txt file (/tmp/wp-release/readme.txt)\n  * Create a version file (/tmp/wp-release/version.txt)\n\n## Configuration\n\nPlugin uses no environment variables, but has a lot of configuration options\n\n### Options\n\n| Options           | Description                                               | Default                                                               |\n|-------------------|-----------------------------------------------------------|-----------------------------------------------------------------------|\n| `type`            | Type of the package to create. Can be `plugin` or `theme` | None. **You must set this explicitly**                                |\n| `slug`            | Package slug.                                             | None. **You must set this explicitly**                                |\n| `path`            | The path of root folder that contains plugin or theme     | `./`                                                                  |\n| `withAssets`      | Does the package have assets (screenshots, banners, logo) | `false`                                                               |\n| `withReadme`      | Does the package have a readme.txt file                   | `false`                                                               |\n| `withVersionFile` | Do we need to create a file with the next release version | `true`                                                                |\n| `releasePath`     | Base path for all of the release files                    | `/tmp/wp-release`                                                     |\n| `versionFiles`    | Array of additional files containing the package version. | `[]`                                                                  |\n| `include`         | Files to include in the package zip file.                 | `**/*`                                                                |\n| `exclude`         | Files to exclude from the package zip file                | List of files and folders defined in [constants.ts](lib/constants.ts) |\n\n### Versioning\n\nPlugin will automatically replace versions in your main file (for plugins) and the ``style.css`` file (for themes).\nWe follow the WordPress codex, so your plugin file must have the same slug as the plugin folder.\n\nIf you have other variables which need to have the version replaced, you can add them to the `versionFiles` option.\n\nIf you need any further processing of the package files, next release version will be output to `/tmp/wp-release/VERSION` file, if the `withVersionFile` option is set to `true`.\n\n\u003e [!IMPORTANT]\n\u003e Version in your plugin / theme must be set to 0.0.0 for this plugin to work\n\n### Assets\nIf your package is on [wp.org](https://wordpress.org) repository, you might have assets (screenshots, banners, logos) which you want to include in the assets file. Plugin respects the Codex, and expects those to be in ``.wordpress-org/assets`` folder. Main theme screenshot should be named ``screenshot`` and should be there as well.\n\n### Readme\nreadme.txt is a special Markdown file needed for packages on [wp.org](https://wordpress.org) to work. It can be in the `.wordpress-org` folder, or in the repository root.  \nPlugin will automatically replace the version in the file if the `withReadme` option is set to `true`.\n\n\u003e [!WARNING]\n\u003e Version in your readme.txt must also be set to 0.0.0 for this plugin to work\n\n### Include / Exclude\nBy default, plugin will include all files in the package zip file. If you want to exclude some files, you can use the `exclude` option. It accepts an array of files and folders, and uses [glob](https://npmjs.com/package/glob) for path resolution.\nYou can also use the `include` option which works in the same manner.\n\n#### Notes\n\n * Include and exclude options are not mutually exclusive so you can use both.\n * Plugin also looks for `.distinclude` and `.distexclude` / `.distignore` files which take precedence over the options set in the plugin.\n * By default we exclude a lot of build artifacts and files which are not needed in the package. You can see the full list in [constants.ts](lib/constants.ts).\n\n### Examples\n\nPlugin with assets, readme and additional version files\n\n```json\n{\n  \"plugins\": [\n    [\"@semantic-release/wordpress\", {\n      \"type\": \"plugin\",\n      \"slug\" : \"my-plugin\",\n      \"withAssets\": true,\n      \"withReadme\": true,\n      \"withVersionFile\": false,\n      \"versionFiles\": [\n        \"constants.php\",\n        \"includes/db-schema.php\"\n      ]\n    }]\n  ]\n}\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsemantic-release%2Fwordpress","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsemantic-release%2Fwordpress","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsemantic-release%2Fwordpress/lists"}