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.
- Download and move this plugin to your Wordpress's
wp-content/plugins
folder. - Run
composer install
within thewp2grav_exporter
folder to install dependencies. - Enable it via
wp plugin activate wp2grav_exporter
or via the admin gui. - Run
wp wp2grav-all
to export all items. See other options below. - Exported files are located at
WP_ROOT/wp-content/uploads/wp2grav-exports/DATE
- 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.
`wp wp2grav-users will generate Grav user account files.
- 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.
Copy the EXPORT/accounts
folder to your user
directory (e.g. username.yaml files should be placed at user/accounts
).
wp wp2grav-roles
will generate a Grav groups.yaml file.
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
becomeswp_subscriber
). - Wordpress users with administrator roles receive the
wp_administrator
group. - The
wp_administrator
group receivesadmin.super
access along withadmin.login
access. Accounts with these permissions are full admins on the site! - A new Grav group called
wp_authenticated_user
group receivesadmin.login
access. - All accounts receive the "wp_authenticated_user" group.
Copy the EXPORT/config
folder to users/config
.