---
title: Wp2grav_exporter
url: 'https://brendo.org/wp-content/plugins/wp2grav_exporter'
markdown: 'https://brendo.org/wp-content/plugins/wp2grav_exporter.md'
date: '2024-09-27'
description: 'Grav Export Requirements PHP v7.1 or above for the composer dependencies. WP-CLI Working Wordpress 5 site from which content will be exported. R/W access to wp-content/uploads on the Wordpress site. Installation Download and move this plugin to your Wordpress’s wp-content/plugins folder. Run compo…'
---

# Grav Export

## Requirements

PHP v7.1 or above for the composer dependencies. WP-CLI Working Wordpress 5 site from which content will be exported. R/W access to `wp-content/uploads` on the Wordpress site.

## Installation

1. Download and move this plugin to your Wordpress’s `wp-content/plugins` folder.
2. Run `composer install --no-dev` within the `wp2grav_exporter` folder to install dependencies.
3. Enable it via `wp plugin activate wp2grav_exporter` or via the admin gui.
4. Run `wp wp2grav-all` to export all items. See other options below.
5. Exported files are located at `WP_ROOT/wp-content/uploads/wp2grav-exports/DATE`
6. The Grav plugin [https://github.com/david-szabo97/grav-plugin-admin-addon-user-manager](https://brendo.org/wp-content/plugins/wp2grav_exporter/admin-addon-user-manager) is recommended to view and manage users for Grav v1.6 sites.

## Notes

## Exporting Users from Wordpress

### Command

`wp wp2grav-users will generate Grav user account files.

### Results

- User accounts in the export folder under `EXPORT/accounts/`. 
    - Usernames will be padded to a minimum of 3 characters, maximum of 16.
    - If a username is truncated or padded, the username will also have the Wordpress uid to avoid collisions.
    - Passwords in each account are randomly generated, and have no connection with the respective Wordpress account. The password automatically switches to a hashed\_password once the account authenticates for the first time.

### Importing Users to Grav

Copy the `EXPORT/accounts` folder to your `user` directory (e.g. username.yaml files should be placed at `user/accounts`).

## Exporting User Roles from Wordpress

### Command

`wp wp2grav-roles` will generate a Grav groups.yaml file.

### Results

Wordpress user roles export as Grav groups in a `groups.yaml` file at `config/groups.yaml`. Some notes about the role exporting:

- Each Wordpress role is converted to the Grav group `wp_<ROLE_WITH_UNDERSCORES>` (e.g. `subscriber` becomes `wp_subscriber`).
- Wordpress users with administrator roles receive the `wp_administrator` group.
- The `wp_administrator` group receives `admin.super` access along with `admin.login` access. Accounts with these permissions are full admins on the site!
- A new Grav group called `wp_authenticated_user` group receives `admin.login` access.
- All accounts receive the “wp\_authenticated\_user” group.

### Importing User Roles

Copy the `EXPORT/config` folder to `users/config`.

---

## Navigation

- Previous: [Wp-optimize](https://brendo.org/wp-content/plugins/wp-optimize.md)
- Children:
  - [Grav_components](https://brendo.org/wp-content/plugins/wp2grav_exporter/grav_components.md)