Skip to main content

Export/import django-cms plugins across applications.

Project description

Django CMS Plugin Importer/Exporter - Plugie

PyPI version License: MIT wheel

This project extends the functionality of the Django CMS framework by providing a way to import and export plugins from one page to another, across different projects, or even between different Django CMS installations. This is useful when your page exists in a development environment and you want to move it to a production environment, or when you have multiple CMS that uses the same content.

Contributing

If you would like to contribute to this project, please read our CONTRIBUTING file for guidelines.

Features

  • Export / import plugins into / from a JSON file
  • Add custom serializers / deserializers to export /import custom types used in your plugins

Requirements

See the Python/Django/Django CMS for the current release version in the setup file or in our documentation.

Installation

  1. Install the package using pip:
pip install djangocms_plugie
  1. Add djangocms_plugie to your INSTALLED_APPS:
INSTALLED_APPS = [
    ...
    'djangocms_plugie',
    ...
]
  1. Add the following to your urls.py:
urlpatterns = [
    ...
    url(r'^admin/', include('djangocms_plugie.urls')),
    ...
]
  1. Setup 'plugie' from your terminal with the following command:
plugie <project_dir>

This will create a 'plugie_config.json' file and a 'plugie/custom_methods' folder in your project directory, including some default methods.

  • The 'plugie_config.py' file is where you can customize some functionalities of the app.
  • The 'custom_methods' folder is where you can add custom methods that can be used in your custom serializers and deserializers. You also get a 'default.py' file with some default methods that you can use as a reference or that you might want to override.

You can find more information about this in the documentation.

Using Plugie

Exporting Plugins

How to Export Plugins

  1. Go to the Django CMS admin and select the page where you want to export the plugins.

  2. Open the structure sidebar and click the hamburger icon on the right side of the placeholder or plugin tree that you want to export.

  3. Click the 'Export plugins' option.

  4. Check the downloaded JSON file to see the exported plugins.

Importing Plugins

How to Import Plugins

  1. Go to the page where you want to import the plugins.

  2. Open the structure sidebar and click the hamburger icon on the right side of the placeholder or plugin tree where you want to import the plugins.

  3. Click the 'Import plugins' option.

  4. A modal will open where you can select the JSON file previously exported.

  5. Click the 'Import' button.

  6. The plugins will be imported to the selected placeholder or plugin tree.

Documentation

The documentation is available here.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Brought to you by

Formlabs logo

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

djangocms_plugie-0.1.4.tar.gz (30.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

djangocms_plugie-0.1.4-py3-none-any.whl (41.5 kB view details)

Uploaded Python 3

File details

Details for the file djangocms_plugie-0.1.4.tar.gz.

File metadata

  • Download URL: djangocms_plugie-0.1.4.tar.gz
  • Upload date:
  • Size: 30.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.3

File hashes

Hashes for djangocms_plugie-0.1.4.tar.gz
Algorithm Hash digest
SHA256 e66dda55104158c9f6c7d3758d92cd3d3651c3a1648f9b10eda14661ed1a149f
MD5 8512dc8b4c775cbaa5d53d608d7adeca
BLAKE2b-256 14042222e233824bdc91358e5a2a5208a45cd080e64cb5cc2f8515ae79609d26

See more details on using hashes here.

File details

Details for the file djangocms_plugie-0.1.4-py3-none-any.whl.

File metadata

File hashes

Hashes for djangocms_plugie-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 a6a6a49b9dc85c1777b485a16d5ced41e0e1078b838453bebcca272d0677e1b3
MD5 cce334ddc84380d1917ffc1e6bd32af9
BLAKE2b-256 3d363c104de25f1f414590d14449bd3e60d3ec6ef88492cf4f61e93bcc45dd2c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page