KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

wp-cli-login-command

★ 324 Open GitHub ↗

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# WP-CLI Login Command

[![Test](https://github.com/aaemnnosttv/wp-cli-login-command/actions/workflows/test.yml/badge.svg)](https://github.com/aaemnnosttv/wp-cli-login-command/actions/workflows/test.yml)
[![Packagist](https://img.shields.io/packagist/v/aaemnnosttv/wp-cli-login-command.svg)](https://packagist.org/packages/aaemnnosttv/wp-cli-login-command)

Quick links: [Using](#using) | [Installation](#installation) | [Contributing](#contributing)

## Using

```
NAME

wp login

DESCRIPTION

Manage magic passwordless sign-in.

SYNOPSIS

wp login <command>

SUBCOMMANDS

create          Create a magic sign-in link for the given user.
  email           Email a magic sign-in link to the given user.
  install         Install/update the companion server plugin.
  invalidate      Invalidate any existing magic links.
  toggle          Toggle the active state of the companion server plugin.

```

### `create` / `as`

```
wp login create <user> [options]
```
or alternatively use the alias
```
wp login as <user> [options]
```

Create a magic sign-in link for the given user.  Outputs the created URL with some extra information for the user regarding usage and expiration.  URLs expire 15 minutes after creation ([configurable](#--expiresseconds)), or at the time of use, whichever comes first.

> `<user>` can be passed as an User ID, username/login or email address. This is the same for all `login` commands which accept this as a parameter.

#### `--expires=<seconds>`

Set the lifetime of the magic link in seconds.

10 minutes = 600
    1 hour     = 3600
    1 day      = 86400

Default: `900` (15 minutes)

#### `--redirect-url=<url>`

Set the URL to redirect to upon successfully logging in. Defaults to `admin_url()`.

> Note: The redirect is executed using [`wp_safe_redirect`](https://developer.wordpress.org/reference/functions/wp_safe_redirect/) which restricts the destination URL using a list of allowed hosts. By default, this is limited to the domain of the site, but can be extended using the [`allowed_redirect_hosts`](https://developer.wordpress.org/reference/hooks/allowed_redirect_hosts/) filter.

#### `--url-only`

Outputs the created sign-in URL only. Great for scripting, piping to your clipboard, or anything else you can think of.

#### `--launch`

Launches the sign-in link your default browser immediately after creation.  This is the fastest possible way to login.

### `email`

```
wp login email <user> [options]
```

Email a magic sign-in link to the given user.  Sends a nice HTML email to the user's email address containing their freshly created magic sign-in link.  Planning to add support for both HTML and plain text emails in the future.

#### `--expires=<seconds>`

[See above.](#--expiresseconds)

#### `--redirect-url=<url>`

[See above.](#--redirect-urlurl)

#### `--subject=<email-subject>`

Optionally override the default email subject with your own custom string. You may use the `{{ domain }}` placeholder.

Default: Magic log-in link for {{domain}}

#### `--template=<path-to-custom-template>`

Optionally override the default email template with your own by providing the path to a different template file to use.
The email template is compiled using the Mustache template engine, so you may use the `{{ magic_url }}` and `{{ domain }}` placeholders in your custom template.  The default template can be found in this repository under `template/email-default.mustache`.

### `install`

```
wp login install [options]
```

Install/update the companion server plugin.  Installing the companion plugin is required before magic links will work on the host.
The `login` command is aware of the installed version of the plugin, and will inform you if it needs to be installed, activated or upgraded.
If the plugin is already installed, you will be prompted to overwrite it.

#### `--activate`

Optionally activate the plugin immediately after installation.

#### `--mu`

Install as a Must Use plugin.

#### `--yes`

Suppress prompting for confirmation to overwrite the existing plugin.

> Using a Composer-based WordPress install? You can require the companion plugin using the package `aaemnnosttv/wp-cli-login-server`.

### `invalidate`

```
wp login invalidate
```

Invalidate any existing magic sign-in links.  Any previously created links will most likely go to a 404 page.

### `toggle`

```
wp login toggle [<on|off>]
```

Toggles the active status of the companion plugin.  Optionally pass `on` or `off` to set the activation accordingly. Without it, the status is simply inverted.

## Installation

Installing this package requires WP-CLI v0.23.0 or greater. Update to the latest stable release with `wp cli update`.

Once you've done so, you can install this package with `wp package install aaemnnosttv/wp-cli-login-command`.

## Contributing

We appreciate you taking the initiative to contribute to this project.

Contributing isn’t limited to just code. We encourage you to contribute in the way that best fits your abilities, by writing tutorials, giving a demo at your local meetup, helping other users with their support questions, or revising our documentation.

### Reporting a bug

Think you’ve found a bug? We’d love for you to help us get it fixed.

Before you create a new issue, you should [search existing issues](https://github.com/aaemnnosttv/wp-cli-login-command/issues?q=label%3Abug%20) to see if there’s an existing resolution to it, or if it’s already been fixed in a newer version.

Once you’ve done a bit of searching and discovered there isn’t an open or fixed issue for your bug, please [create a new issue](https://github.com/aaemnnosttv/wp-cli-login-command/issues/new) with the following:

1. What you were doing (e.g. "When I run `wp post list`").
2. What you saw (e.g. "I see a fatal about a class being undefined.").
3. What you expected to see (e.g. "I expected to see the list of posts.")

Include as much detail as you can, and clear steps to reproduce if possible.

### Creating a pull request

Want to contribute a new feature? Please first [open a new issue](https://github.com/aaemnnosttv/wp-cli-login-command/issues/new) to discuss whether the feature is a good fit for the project.

Once you've decided to commit the time to seeing your pull request through, please follow our guidelines for creating a pull request to make sure it's a pleasant experience:

1. Create a feature branch for each contribution.
2. Submit your pull request early for feedback.
3. Include functional tests with your changes. [Read the WP-CLI documentation](https://make.wordpress.org/cli/handbook/contributions/pull-requests/#running-and-writing-tests) for an introduction.
4. Follow [PSR-2 Coding Standards](http://www.php-fig.org/psr/psr-2/).

wp-cli-login-command

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README