Skip to content

jgonyea/wp2grav_exporter

develop
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 

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 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.

About

Exports Wordpress content to GravCMS

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published