Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/wp-pot/wp-pot

Generate pot file for WordPress plugins and themes
https://github.com/wp-pot/wp-pot

hacktoberfest poedit pot translator wordpress wp-pot

Last synced: 3 months ago
JSON representation

Generate pot file for WordPress plugins and themes

Host: GitHub
URL: https://github.com/wp-pot/wp-pot
Owner: wp-pot
License: mit
Created: 2016-12-04T11:20:34.000Z (about 8 years ago)
Default Branch: master
Last Pushed: 2024-04-25T14:28:51.000Z (9 months ago)
Last Synced: 2024-04-25T15:39:39.339Z (9 months ago)
Topics: hacktoberfest, poedit, pot, translator, wordpress, wp-pot
Language: JavaScript
Homepage: https://www.npmjs.com/package/wp-pot
Size: 1.24 MB
Stars: 73
Watchers: 2
Forks: 15
Open Issues: 14
Metadata Files:
- Readme: readme.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md

Awesome Lists containing this project

README

# wp-pot

## Information

[![GitHub Workflow Status](https://img.shields.io/github/workflow/status/wp-pot/wp-pot/Node%20CI/master)](https://github.com/wp-pot/wp-pot/actions) [![npm version](https://badge.fury.io/js/wp-pot.svg)](https://www.npmjs.com/package/wp-pot) [![Average time to resolve an issue](https://isitmaintained.com/badge/resolution/wp-pot/wp-pot.svg)](https://isitmaintained.com/project/wp-pot/wp-pot "Average time to resolve an issue") [![Percentage of issues still open](https://isitmaintained.com/badge/open/wp-pot/wp-pot.svg)](https://isitmaintained.com/project/wp-pot/wp-pot "Percentage of issues still open")

| Package | wp-pot |
| ----------- | ---------------------------------------------------- |
| Description | Generate pot files for WordPress plugins and themes. |

## Like my work and want to say thanks?

Do it here:
[![Buy Me A Coffee](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/rasmus)

## Install

```sh
npm install --save-dev wp-pot
```

## Example usage

### PHP File Parsing

```js
const wpPot = require('wp-pot');

wpPot({
destFile: 'file.pot',
domain: 'domain',
package: 'Example project',
src: 'src/*.php'
});
```

### JS File Parsing (only js, no jsx for now)

```js
wpPot({
parser: 'js',
parserOptions: {
ecmaVersion: 6,
},
src: 'test/fixtures/edge-cases.js'
});
```

## Options

*All options is optional*

- `bugReport`
Description: Header with URL for reporting translation bugs.
Type: `string`
Default: undefined
- `commentKeyword`
Description: Keyword to trigger translator comment.
Type: `string`
Default: `translators:`
- `copyrightText`
Description: Copyright text
Type: `function|string`
Default: A function that takes `options` object as a argument and return the default copyright text.
- `domain`
Description: Domain to retrieve the translated text. All textdomains is included if undefined.
Type: `string`
Default: undefined
- `destFile`
Description: Filename for template file.
Type: `string`
Default: `domain.pot` or `translations.pot` if domain is undefined.
- `headers`
Description: Object containing all default headers. Set to false to not generate the default extra headers for Poedit.
Type: `object|bool`
Default: Headers used by Poedit.
- `gettextFunctions`
Description: Gettext functions used for finding translations.
Type: `object`
Default: WordPress translation functions.
- `includePOTCreationDate`
Description: Auto-populate the `POT-Creation-Date` header.
Type: `bool`
Default: true
- `lastTranslator`
Description: Name and email address of the last translator (ex: `John Doe `).
Type: `string`
Default: undefined
- `metadataFile`
Description: Path to file containing plugin/theme metadata header relative to `relativeTo`
Type: `string`
Default: undefined
- `noFilePaths`
Description: Do not print out file references in pot file.
Type: `bool`
Default: false
- `package`
Description: Package name.
Type: `string`
Default: `domain` or `unnamed project` if domain is undefined.
- `parser`
Description: PHP or JS parser
Type: `string`
Default: `php`
- `parserOptions`
Description: Options for the JS parser Espree. See [here](https://github.com/eslint/espree#options).
Type: `object`
Default: `{ comment: true, loc: true }`
- `relativeTo`
Description: Path to folder that file comments should be relative to.
Type: `string`
Default: `destFile` location or current working directory if `destFile` is undefined.
- `src`
Description: Glob or globs to match files
Type: `string|array`
Default: `**/*.php`
- `globOpts`
Description: [node-glob options](https://github.com/isaacs/node-glob#options) object to be passed through.
Type: `Object`
Default: `{}`
- `team`
Description: Name and email address of the translation team (ex: `Team `).
Type: `string`
Default: undefined
- `writeFile`
Description: Write pot-file to disk. The function always returns the contents as well.
Type: `boolean`
Default: `true`
- `ignoreTemplateNameHeader`
Description: Do not extract `/* Template Name: String */` headers to POT file.
Type: `boolean`
Default: `false`

## Related

- [php-parser](https://github.com/glayzzle/php-parser) - NodeJS PHP Parser used in this project
- [gulp-wp-pot](https://github.com/wp-pot/gulp-wp-pot) - Run wp-pot via gulp
- [wp-pot-cli](https://github.com/wp-pot/wp-pot-cli) - Run wp-pot via cli command

## License