# node-wp-i18n

> Internationalize WordPress themes and plugins.

Latest version **1.2.8** (published 2025-07-08) · MIT license · 0 weekly downloads

## Install

```sh
npm install node-wp-i18n
pnpm add node-wp-i18n
yarn add node-wp-i18n
bun add node-wp-i18n
```

Provides the command `wpi18n`.

## Health

**Score 25/100 (F)** — status: maintenance-mode.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: stale; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.2.8 |
| Published | 2025-07-08 |
| First published | 2016-08-10 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 7 |
| Unpacked size | 151.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 46 |
| Author | Brady Vercher |
| Maintainers | bradyvercher |
| Keywords | wordpress, i18n, translation |

## Links

- npm: https://www.npmjs.com/package/node-wp-i18n
- Repository: https://github.com/cedaro/node-wp-i18n
- Issues: https://github.com/cedaro/node-wp-i18n/issues
- npm.io page: https://npm.io/package/node-wp-i18n

## Dependencies (7)

- [tmp](https://npm.io/package/tmp.md) ^0.2.1
- [glob](https://npm.io/package/glob.md) ^11.0.3
- [lodash](https://npm.io/package/lodash.md) ^4.14.2
- [mkdirp](https://npm.io/package/mkdirp.md) ^3.0.1
- [bluebird](https://npm.io/package/bluebird.md) ^3.4.1
- [minimist](https://npm.io/package/minimist.md) ^1.2.5
- [gettext-parser](https://npm.io/package/gettext-parser.md) ^3.1.1

## Alternatives

- [messageformat](https://npm.io/package/messageformat.md) — 329.7K weekly downloads
- [@mintlify/scraping](https://npm.io/package/@mintlify/scraping.md) — 294.8K weekly downloads
- [@mintlify/previewing](https://npm.io/package/@mintlify/previewing.md) — 209.5K weekly downloads
- [@mintlify/prebuild](https://npm.io/package/@mintlify/prebuild.md) — 209.5K weekly downloads
- [@mintlify/link-rot](https://npm.io/package/@mintlify/link-rot.md) — 206.3K weekly downloads

## Recent versions

- 1.2.8 (latest) — 2025-07-08
- 1.2.7 — 2022-11-09
- 1.2.6 — 2021-08-02
- 1.2.5 — 2021-02-03
- 1.2.4 — 2021-01-07
- 1.2.3 — 2019-02-05
- 1.2.2 — 2018-12-21
- 1.2.1 — 2018-08-20
- 1.2.0 — 2018-06-19
- 1.1.1 — 2018-04-11
- 1.1.0 — 2018-04-03
- 1.0.5 — 2018-02-08
- 1.0.4 — 2017-10-30
- 1.0.3 — 2017-10-12
- 1.0.2 — 2017-02-07
- … 2 more at https://npm.io/package/node-wp-i18n/versions

## README

# node-wp-i18n [![Build Status](https://travis-ci.org/cedaro/node-wp-i18n.png?branch=develop)](https://travis-ci.org/cedaro/node-wp-i18n)

> Internationalize WordPress plugins and themes.

WordPress has a robust suite of tools to help internationalize plugins and themes. This plugin brings the power of those existing tools to Node.js in order to make it easy for you to automate the i18n process and make your projects more accessible to an international audience.

If you're not familiar with i18n concepts, read the Internationalization entries in the [Plugin Developer Handbook](https://developer.wordpress.org/plugins/internationalization/) or [Theme Developer Handbook](https://developer.wordpress.org/themes/functionality/internationalization/).

node-wp-i18n started as the core of the [grunt-wp-i18n](https://github.com/cedaro/grunt-wp-i18n) plugin, but has been extracted and rewritten to be more useful as a standalone module and with other tools.


## Getting Started

`node-wp-i18n` includes a basic CLI tool to help generate POT file or add text domains to i18n functions in WordPress plugins or themes. Installing this module globally will allow you to access the `wpi18n` command:

```sh
npm install -g node-wp-i18n
```

Once installed, run this command from a plugin or theme to see the available options:

```sh
wpi18n -h
```

Running `wpi18n info` in a plugin or theme directory will show you information about that package.


### Requirements

* [PHP CLI](http://www.php.net/manual/en/features.commandline.introduction.php) must be in your system path.

---
_Source: https://npm.io/package/node-wp-i18n · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._