{"id":13774372,"url":"https://github.com/django-cms/cmsplugin-filer","last_synced_at":"2025-05-11T06:32:59.477Z","repository":{"id":701049,"uuid":"346746","full_name":"django-cms/cmsplugin-filer","owner":"django-cms","description":"DEPRECATED, this project is no longer maintained, see README for more information.","archived":true,"fork":false,"pushed_at":"2019-11-27T08:27:53.000Z","size":1002,"stargazers_count":127,"open_issues_count":53,"forks_count":173,"subscribers_count":8,"default_branch":"develop","last_synced_at":"2024-11-09T04:04:35.660Z","etag":null,"topics":["deprecated"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/django-cms.png","metadata":{"files":{"readme":"README.rst","changelog":"HISTORY","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2009-10-23T01:54:08.000Z","updated_at":"2024-10-31T17:08:33.000Z","dependencies_parsed_at":"2022-07-07T15:01:08.513Z","dependency_job_id":null,"html_url":"https://github.com/django-cms/cmsplugin-filer","commit_stats":null,"previous_names":["divio/cmsplugin-filer","stefanfoulis/cmsplugin-filer"],"tags_count":35,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/django-cms%2Fcmsplugin-filer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/django-cms%2Fcmsplugin-filer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/django-cms%2Fcmsplugin-filer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/django-cms%2Fcmsplugin-filer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/django-cms","download_url":"https://codeload.github.com/django-cms/cmsplugin-filer/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224964698,"owners_count":17399434,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["deprecated"],"created_at":"2024-08-03T17:01:26.104Z","updated_at":"2024-11-17T09:30:46.906Z","avatar_url":"https://github.com/django-cms.png","language":"Python","funding_links":[],"categories":["Add-ons","Python"],"sub_categories":[],"readme":"**Deprecated**\n\nThis project is no longer supported.\n\nDivio will undertake no further development or maintenance of this project. If you are interested in  taking responsibility for this project as its maintainer, please contact us via www.divio.com.\n\nPlease have a look at the following forks or alternatives:\n\n* https://github.com/pawelmarkowski/cmsplugin-filer\n* https://github.com/divio/djangocms-picture\n* https://github.com/divio/djangocms-file\n* https://github.com/divio/djangocms-link\n* https://github.com/divio/djangocms-video\n\n===============\ncmsplugin-filer\n===============\n\nA set of cms plugins that replace the plugins shipped with django-cms with\nversions that use file fields from django-filer.\n\nWarning: ::\n\n    Starting with version 1.1.0, support for Python 2.6, Django 1.7 or lower\n    and django CMS 3.0.x and lower was dropped. Please pin your dependencies\n    to ``cmsplugin-filer\u003c1.1.0`` for older projects.\n\n    Starting with version 0.10 support for django CMS 2.x was dropped\n    (table renaming magic removal). Pin your dependencies to\n    ``cmsplugin-filer\u003c0.10`` for django-cms 2.x projects.\n\n\nDependencies\n============\n\n* django-filer \u003e= 1.2\n* Django \u003e= 1.8\n* django-cms \u003e= 3.1\n* django-sekizai \u003e= 0.4.2\n* easy_thumbnails \u003e= 1.0\n* django-appconf\n* djangocms-attributes-field\n\n\nInstallation\n============\n\nTo get started using ``cmsplugin-filer``:\n\n- install it with ``pip``::\n\n    $ pip install cmsplugin-filer\n\n- configure ``django-filer`` as documented in https://django-filer.readthedocs.io/en/latest/installation.html#configuration\n\n- add the plugins to ``INSTALLED_APPS``::\n\n    INSTALLED_APPS = (\n        ...\n        'cmsplugin_filer_file',\n        'cmsplugin_filer_folder',\n        'cmsplugin_filer_link',\n        'cmsplugin_filer_image',\n        'cmsplugin_filer_teaser',\n        'cmsplugin_filer_video',\n        ...\n    )\n\n\n- run ``migrate``.\n\nYou can also set ``FILER_IMAGE_USE_ICON`` in your ``settings.py`` to configure\n``cmsplugin_filer_image`` plugin to use 32x32 icons for representing\nplugin instances.\n\nThe default template in ``cmsplugin_filer_image`` expects the subject location functionality to be enabled.\nFollow: https://django-filer.readthedocs.io/en/latest/installation.html#subject-location-aware-cropping\n\nUpgrading to version 1.1\n========================\n\nIn version 1.1 there are two backward incompatible changes:\n\nMigrations layout\n-----------------\n\nMigrations have been moved back to the standard location. cmsplugin_filer related\n``MIGRATION_MODULE`` setting items **must** be removed for cmsplugin_filer 1.1 to work\n\nRemoval of ``ThumbnailOption`` model\n------------------------------------\n``ThumbnailOption`` has been moved to ``filer`` (since filer 1.2).\nYou **must** update your models and migrations referencing ``ThumbnailOption`` for this to work.\n\nUpgrade process involves updating your models and migrations.\n\nmodel.py\n^^^^^^^^\n\nAdd::\n\n    try:\n        from filer.models import ThumbnailOption\n        thumbnail_model = 'filer.ThumbnailOption'\n    except ImportError:\n        from cmsplugin_filer_image.models import ThumbnailOption\n        thumbnail_model = 'cmsplugin_filer_image.ThumbnailOption'\n\nIf you use the string syntax (e.g.: ``thumb_field = models.ForeignKey('cmsplugin_filer_image.ThumbnailOption')``)\nuse ``thumbnail_model`` string as defined above (e.g.: ``thumb_field = models.ForeignKey(thumbnail_model)``\nIf using the model directly you don't have to change the fields definition\n\nDjango 1.7+ migrations\n^^^^^^^^^^^^^^^^^^^^^^\n\nFor every migration file that references ``ThumbnailOption`` add the following import::\n\n    from myapp.models import thumbnail_model\n\nand change all ``'cmsplugin_filer_image.ThumbnailOption'`` to ``thumbnail_model``\n\nSouth migrations\n^^^^^^^^^^^^^^^^\n\nIn every migration file add the following import::\n\n    from myapp.models import thumbnail_model\n\nand change all ``'cmsplugin_filer_image.ThumbnailOption'`` to ``thumbnail_model`` and\n``u\"orm['cmsplugin_filer_image.ThumbnailOption']\"`` to ``u\"orm['%s']\" % thumbnail_model``.\n\n\nThe default template in ``cmsplugin_filer_image`` expects the subject location\nfunctionality to be enabled.\nFollow: http://django-filer.readthedocs.org/en/0.9.2/installation.html#subject-location-aware-cropping\n\nPlease note that current develop version moved plugin packages from `src`\ndirectory to project root. This may break your installation if upgrading.\nUninstall any previous `cmsplugin_filer` installation (either from PyPI or\nfrom github repository) and reinstall it.\n\n\nIntegrations\n============\n\n\n``djangocms-text-ckeditor``\n---------------------------\n\n``cmsplugin_filer_image`` provides integration with\n`djangocms-text-ckeditor \u003chttp://pypi.python.org/pypi/djangocms-text-ckeditor/\u003e`__.\nAdd this setting to enable it::\n\n    TEXT_SAVE_IMAGE_FUNCTION='cmsplugin_filer_image.integrations.ckeditor.create_image_plugin'\n\nThis allows dragging images into the text editor in Firefox and newer versions\nof IE.\n\n\nCustomisation\n-------------\n\nMost plugins (file, folder, image and teaser) support configuring custom\n\"styles\" (templates).\n\ne.g add the following settings for the image plugin::\n\n    CMSPLUGIN_FILER_IMAGE_STYLE_CHOICES = (\n        ('default', 'Default'),\n        ('boxed', 'Boxed'),\n    )\n    CMSPLUGIN_FILER_IMAGE_DEFAULT_STYLE = 'boxed'\n\nNow, if a template exists at ``cmsplugin_filer_image/plugins/image/boxed.html``\nit will be used. If not, it will fall back to ``cmsplugin_filer_image/plugins/image/default.html``.\nIf a css class in the default template is enough, it can be used in the\ntemplate as ``{{ instance.style }}``.\n\nFor backwards compatibility the plugin will always use ``cmsplugin_filer_image/image.html`` if it exists. Remove that\ntemplate after migrating to the new structure.\n\n\nClasses\n-------\n\nClasses like ``left``, ``center``, ``right`` and ``img-responsive`` are given by the plugin to use in your own projects.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjango-cms%2Fcmsplugin-filer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdjango-cms%2Fcmsplugin-filer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjango-cms%2Fcmsplugin-filer/lists"}