Skip to content

Commit f1d2a06

Browse files
docs: update README (#57)
* DOCS: update README Add a "migrate from cmsplugin" management command mention in README * docs: update README Improve the "migrate from cmsplugin" mention, add a link to the deprecate_cmsplugin_filer app.
1 parent f77faf9 commit f1d2a06

File tree

1 file changed

+16
-0
lines changed

1 file changed

+16
-0
lines changed

README.rst

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -98,3 +98,19 @@ You can run tests by executing::
9898
:target: https://www.djangoproject.com/
9999
.. |djangocms| image:: https://img.shields.io/badge/django%20CMS-3.7%2B-blue.svg
100100
:target: https://www.django-cms.org/
101+
102+
103+
Updating from `cmsplugin-filer <https://github.com/django-cms/cmsplugin-filer>`_
104+
--------------------------------------------------------------------------------
105+
106+
Historically, `cmsplugin-filer` was used to create file, folder, image, link, teaser & video plugins on your django CMS projects. Now `cmsplugin-filer` has been archived, you can still migrate your old instances without having to copy them manually to the new `djangocms-<file|picture|link|...>` plugins.
107+
108+
There's a third-party management command that supports your migration:
109+
110+
`migrate_cmsplugin_filer.py <https://gist.github.com/corentinbettiol/84a6ea7e4d047fc01861b0af15fd60f0>`_
111+
112+
This management command is only a starting point. It *has* worked out of the box for some people, but we encourage you to read the code, understand what it does, and test it on a development environment before running it on your production server.
113+
114+
The management command is only configured to transfer your `cmsplugin_link`, `cmsplugin_file`, `cmsplugin_folder` and `cmsplugin_image` plugins to modern `djangocms_*` plugins. If you need to transfer other `cmsplugin_*` plugins, you'll have to write your own code.
115+
116+
Alternatively you can use the `deprecate_cmsplugin_filer <https://github.com/ImaginaryLandscape/deprecate_cmsplugin_filer>`_ app, which only adds a small migration that transfer the old `cmsplugin-filer` plugins instances to the new `djangocms-<file|picture|link|...>` plugins.

0 commit comments

Comments
 (0)