epflidevelop/os-wp-mgmt repository overview

⁠ ⁠
jahia2wp

⁠ Control your migration from Jahia to WordPress

⁠ ⁠ ⁠ ⁠ ⁠

⁠Install and Usage

Head to the documentation⁠ for next practical steps

⁠Roadmap and Overview

⁠30/11/2017, Naked WordPress : Went Live :airplane:

We spent 6 sprints⁠ to focus on automation and maintenance, with the objective of driving all the creation process from one shared spreadsheet (aka configuration source).

1. :balloon: installing a functional WordPress to any given URL

   1. Create a file named generate.yaml containing the following:

      
      langs: en
      unit_name: si-dev
      unit_id: 13028
      
      

      Copy

   2. Type the following commands:

      $ export PLUGINS_CONFIG_BASE_PATH=/srv/$WP_ENV/jahia2wp/data/plugins $ python jahia2wp.py generate $WP_ENV http://localhost⁠ --extra-config=generate.yaml --admin-password=admin $ wp --path=/srv/$WP_ENV/localhost/htdocs option update plugin:epfl_tequila:has_dual_auth 1 $ python jahia2wp.py generate $WP_ENV http://localhost/test2⁠ --extra-config=generate.yaml --admin-password=admin $ wp --path=/srv/$WP_ENV/localhost/htdocs/test2 option update plugin:epfl_tequila:has_dual_auth 1 ...

      $ python jahia2wp.py check $WP_ENV http://localhost⁠ WordPress site valid and accessible at http://localhost⁠

      $ python jahia2wp.py admins $WP_ENV http://localhost⁠ admin:[email protected]⁠ user123456:[email protected]⁠

💡 In lieu of the --admin-password flag, one can gain access through PHPMyAdmin⁠ 💡 If you want to start over with a clean slate (e.g. after an error):

    $ rm -rf /srv/$WP_ENV/localhost/htdocs/

2. :tada: add, list plugins

    $ python jahia2wp.py extract-plugin-config $WP_ENV http://localhost output_file
    ...

    $ python jahia2wp.py list-plugins $WP_ENV http://localhost
    Plugin list for site 'localhost':
    - mainwp-child
      - action   : install
      - activated: True
      - src      : web
    - tequila
      - action   : install
      - activated: True
    ...

    $ python jahia2wp.py list-plugins $WP_ENV http://localhost --config --plugin=tequila      - tequila
    - action     : install
      - activated: True
      - src      : /srv/ebreton/jahia2wp/data/plugins/generic/tequila/v1/tequila.zip
    - tables
      + term_relationships
      + termmeta
      + terms
      + options
      + term_taxonomy
      + postmeta
    

3. :construction: maintaining the website and the plugins

    $ python jahia2wp.py version $WP_ENV http://localhost
    4.8

    $ python jahia2wp.py clean $WP_ENV http://localhost
    ...

    $ python jahia2wp.py backup $WP_ENV http://localhost
    ...

4. :champagne: applying those them functionalities to every row of our configuration source

    $ python jahia2wp.py generate-many path/to/source.csv
    ...

    $ python jahia2wp.py backup-many path/to/source.csv
    ...

    $ python jahia2wp.py inventory $WP_ENV /srv/your-env/localhost
    INFO - your-env - inventory - Building inventory...
    path;valid;url;version;db_name;db_user;admins
    ...

⁠Migration

1. :gift_heart: Export the content of a Jahia website as a zipped package

    $ python jahia2wp.py download dcsl --username=foo
    Jahia password for user 'foo':
    ...
   

   Copy

2. :tent: Parse zipped package (XML and files) as python objects

3. :tent: Import parsed pages into WordPress (raw content)

4. :tent: Support translation, hierarchy, menu, sidebar

5. Import static Jahia boxes into WordPress (shortcodes)

6. Import web-services powered Jahia boxes into WordPress (people, faq, actu, memento, infoscience, and so on ...)

⁠Help

Calling jahia2wp.py with -h will give you details on available options

$ python jahia2wp.py -h
...

⁠Changelog

All notable changes to this project are documented in CHANGELOG.md⁠.

⁠Contribution

Check out CONTRIBUTING.md⁠ for more details

As well as our CODE_OF_CONDUCT.md⁠, where we pledge to making participation in our project and our community a harassment-free experience for everyone

⁠Contributor list

Big up to all the following people, without whom this project will not be

Manu B.⁠	Manu J. ⁠	Greg⁠	Lulu⁠	Laurent⁠	Luc⁠
Dominique⁠	Nicolas ⁠	William ⁠	CampToCamp⁠