{"id":18831392,"url":"https://github.com/django-cms/djangocms-file","last_synced_at":"2025-04-04T22:02:24.358Z","repository":{"id":13816454,"uuid":"16512883","full_name":"django-cms/djangocms-file","owner":"django-cms","description":"django CMS File is a set of plugins for django CMS that allow you to add files to your site You can either choose a single file or an entire folder.","archived":false,"fork":false,"pushed_at":"2025-03-06T15:34:33.000Z","size":409,"stargazers_count":31,"open_issues_count":0,"forks_count":23,"subscribers_count":26,"default_branch":"master","last_synced_at":"2025-03-28T21:01:50.268Z","etag":null,"topics":["addon","cms","django","django-cms","python"],"latest_commit_sha":null,"homepage":"https://www.django-cms.org/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/django-cms.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG.rst","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-02-04T13:44:40.000Z","updated_at":"2025-03-06T15:34:36.000Z","dependencies_parsed_at":"2024-03-19T00:32:03.740Z","dependency_job_id":"2a434d26-9a02-48ba-9010-d100436db4cc","html_url":"https://github.com/django-cms/djangocms-file","commit_stats":{"total_commits":82,"total_committers":15,"mean_commits":5.466666666666667,"dds":0.5487804878048781,"last_synced_commit":"f77faf99fd1359496c78db71e78be79087e509ed"},"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/django-cms%2Fdjangocms-file","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/django-cms%2Fdjangocms-file/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/django-cms%2Fdjangocms-file/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/django-cms%2Fdjangocms-file/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/django-cms","download_url":"https://codeload.github.com/django-cms/djangocms-file/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247256102,"owners_count":20909240,"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":["addon","cms","django","django-cms","python"],"created_at":"2024-11-08T01:53:45.187Z","updated_at":"2025-04-04T22:02:24.342Z","avatar_url":"https://github.com/django-cms.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"===============\ndjango CMS File\n===============\n\n|pypi| |build| |coverage| |python| |django| |djangocms|\n\n**django CMS File** is a set of plugins for `django CMS \u003chttp://django-cms.org\u003e`_\nthat allow you to add files to your site You can either choose a single file or\nan entire folder.\n\nIt uses files managed by `Django Filer \u003chttps://github.com/divio/django-filer\u003e`_.\n\nThis addon is compatible with `Divio Cloud \u003chttp://divio.com\u003e`_\nfor easy installation.\n\n.. image:: preview.gif\n\n\nContributing\n============\n\nThis is a an open-source project. We'll be delighted to receive your\nfeedback in the form of issues and pull requests. Before submitting your\npull request, please review our `contribution guidelines\n\u003chttp://docs.django-cms.org/en/latest/contributing/index.html\u003e`_.\n\nWe're grateful to all contributors who have helped create and maintain this package.\nContributors are listed at the `contributors \u003chttps://github.com/divio/djangocms-file/graphs/contributors\u003e`_\nsection.\n\nOne of the easiest contributions you can make is helping to translate this addon on\n`Transifex \u003chttps://www.transifex.com/projects/p/djangocms-file/\u003e`_.\n\n\nDocumentation\n=============\n\nSee ``REQUIREMENTS`` in the `setup.py \u003chttps://github.com/divio/djangocms-file/blob/master/setup.py\u003e`_\nfile for additional dependencies:\n\n* Django Filer 1.7 or higher\n\nMake sure `django-filer \u003chttp://django-filer.readthedocs.io/en/latest/installation.html\u003e`_\nis installed and configured appropriately.\n\n\nInstallation\n------------\n\nFor a manual install:\n\n* run ``pip install djangocms-file``\n* add ``djangocms_file`` to your ``INSTALLED_APPS``\n* run ``python manage.py migrate djangocms_file``\n\n\nConfiguration\n-------------\n\nNote that the provided templates are very minimal by design. You are encouraged\nto adapt and override them to your project's requirements.\n\nThis addon provides a ``default`` template for all instances. You can provide\nadditional template choices by adding a ``DJANGOCMS_FILE_TEMPLATES``\nsetting::\n\n    DJANGOCMS_FILE_TEMPLATES = [\n        ('feature', _('Featured Version')),\n    ]\n\nYou'll need to create the ``feature`` folder inside ``templates/djangocms_file/``\notherwise you will get a *template does not exist* error. You can do this by\ncopying the ``default`` folder inside that directory and renaming it to\n``feature``.\n\n\nRunning Tests\n-------------\n\nYou can run tests by executing::\n\n    virtualenv env\n    source env/bin/activate\n    pip install -r test_requirements/base.txt\n    python setup.py test\n\n\n.. |pypi| image:: https://badge.fury.io/py/djangocms-file.svg\n    :target: http://badge.fury.io/py/djangocms-file\n.. |build| image:: https://travis-ci.org/django-cms/djangocms-file.svg?branch=master\n    :target: https://travis-ci.org/divio/djangocms-file\n.. |coverage| image:: https://codecov.io/gh/django-cms/djangocms-file/branch/master/graph/badge.svg\n    :target: https://codecov.io/gh/divio/djangocms-file\n\n.. |python| image:: https://img.shields.io/badge/python-3.5+-blue.svg\n    :target: https://pypi.org/project/djangocms-file/\n.. |django| image:: https://img.shields.io/badge/django-2.2--4.0-blue.svg\n    :target: https://www.djangoproject.com/\n.. |djangocms| image:: https://img.shields.io/badge/django%20CMS-3.7%2B-blue.svg\n    :target: https://www.django-cms.org/\n\n\nUpdating from `cmsplugin-filer \u003chttps://github.com/django-cms/cmsplugin-filer\u003e`_\n--------------------------------------------------------------------------------\n\nHistorically, `cmsplugin-filer` was used to create file, folder, image, link, teaser \u0026 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-\u003cfile|picture|link|...\u003e` plugins.\n\nThere's a third-party management command that supports your migration:\n\n`migrate_cmsplugin_filer.py \u003chttps://gist.github.com/corentinbettiol/84a6ea7e4d047fc01861b0af15fd60f0\u003e`_\n\nThis 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.\n\nThe 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.\n\nAlternatively you can use the `deprecate_cmsplugin_filer \u003chttps://github.com/ImaginaryLandscape/deprecate_cmsplugin_filer\u003e`_ app, which only adds a small migration that transfer the old `cmsplugin-filer` plugins instances to the new `djangocms-\u003cfile|picture|link|...\u003e` plugins.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjango-cms%2Fdjangocms-file","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdjango-cms%2Fdjangocms-file","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjango-cms%2Fdjangocms-file/lists"}