{"id":18246129,"url":"https://github.com/mfcovington/djangocms-shiny-app","last_synced_at":"2025-04-04T14:31:12.130Z","repository":{"id":30485974,"uuid":"34040085","full_name":"mfcovington/djangocms-shiny-app","owner":"mfcovington","description":"A Django app for adding R Shiny apps to a Django site with django CMS-specific features","archived":false,"fork":false,"pushed_at":"2016-03-13T03:57:02.000Z","size":43,"stargazers_count":34,"open_issues_count":2,"forks_count":3,"subscribers_count":2,"default_branch":"develop","last_synced_at":"2025-03-19T01:09:01.382Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://pypi.python.org/pypi/djangocms-shiny-app/","language":"Python","has_issues":true,"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/mfcovington.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}},"created_at":"2015-04-16T07:09:45.000Z","updated_at":"2025-01-13T08:26:47.000Z","dependencies_parsed_at":"2022-09-08T09:01:45.031Z","dependency_job_id":null,"html_url":"https://github.com/mfcovington/djangocms-shiny-app","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mfcovington%2Fdjangocms-shiny-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mfcovington%2Fdjangocms-shiny-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mfcovington%2Fdjangocms-shiny-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mfcovington%2Fdjangocms-shiny-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mfcovington","download_url":"https://codeload.github.com/mfcovington/djangocms-shiny-app/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247193959,"owners_count":20899401,"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":[],"created_at":"2024-11-05T09:24:40.582Z","updated_at":"2025-04-04T14:31:11.829Z","avatar_url":"https://github.com/mfcovington.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"*******************\ndjangocms-shiny-app\n*******************\n\n``djangocms-shiny-app`` is a Django app for adding `R Shiny apps \u003chttp://shiny.rstudio.com\u003e`_ to a Django site with django CMS-specific features.\n\nSource code is available on GitHub at `mfcovington/djangocms-shiny-app \u003chttps://github.com/mfcovington/djangocms-shiny-app\u003e`_.\n\n\n.. contents:: :local:\n\n\nInstallation\n============\n\n**PyPI**\n\n.. code-block:: sh\n\n    pip install djangocms-shiny-app\n\n\n**GitHub (development branch)**\n\n.. code-block:: sh\n\n    pip install git+http://github.com/mfcovington/djangocms-shiny-app.git@develop\n\n\nConfiguration\n=============\n\n\n- `Install django CMS and start a project \u003chttp://docs.django-cms.org/en/latest/introduction/install.html\u003e`_, if one doesn't already exist.\n\n\n- Unless you use this app as part of `djangocms-lab-site \u003chttps://github.com/mfcovington/djangocms-lab-site\u003e`_ or plan to style the app from scratch, you will want to choose the ``Use Twitter Bootstrap Theme`` option (when running ``djangocms``) and then edit the resulting ``templates/base.html``.\n\n  - This will add style that looks like Bootstrap 2. To use Bootstrap 3 styling, remove the following line for the ``bootstrap-theme.min.css`` stylesheet from ``templates/base.html``:\n\n    .. code-block:: python\n\n        \u003clink rel=\"stylesheet\" href=\"https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.x.x/css/bootstrap-theme.min.css\"\u003e\n\n  - The default menu settings for django CMS using Bootstrap will allow the user to access specific lab members via a dropdown menu, but will not give easy access to the summary page of all Shiny apps. To fix this do one of the following:\n\n    - In ``templates/base.html``, change ``{% show_menu 0 1 100 100 \"menu.html\" %}`` to ``{% show_menu 0 0 100 100 \"menu.html\" %}``, or\n\n    - Use a split button dropdowns by changing that line to `{% show_menu 0 100 1 1 '_menu.html' %}` and populate `_menu.html` as done in `djangocms-lab-site \u003chttps://github.com/mfcovington/djangocms-lab-site\u003e`_.\n\n\n- Edit the project's ``settings.py`` file.\n\n  - Add ``cms_shiny`` and its dependencies to ``INSTALLED_APPS``:\n\n  .. code-block:: python\n\n      INSTALLED_APPS = (\n          # ...\n          'cms_shiny',\n          'easy_thumbnails',\n          'filer',\n          'mptt',\n      )\n\n\n  - Add ``easy_thumbnail`` settings: \n\n  .. code-block:: python\n\n      # For easy_thumbnails to support retina displays (recent MacBooks, iOS)\n      THUMBNAIL_HIGH_RESOLUTION = True\n      THUMBNAIL_QUALITY = 95\n      THUMBNAIL_PROCESSORS = (\n          'easy_thumbnails.processors.colorspace',\n          'easy_thumbnails.processors.autocrop',\n          'filer.thumbnail_processors.scale_and_crop_with_subject_location',\n          'easy_thumbnails.processors.filters',\n      )\n      THUMBNAIL_PRESERVE_EXTENSIONS = ('png', 'gif')\n      THUMBNAIL_SUBDIR = 'versions'\n\n\n- To access ``cms_shiny`` pages without using a django CMS AppHook, include URL configurations for ``cms_shiny`` in your project's ``urls.py`` file:\n\n  - For **Django 1.7**:\n\n    .. code-block:: python\n\n        urlpatterns = patterns('',\n            # ...\n            url(r'^shiny_apps/', include('cms_shiny.urls', namespace='cms_shiny')),\n            # ...\n        )\n\n\n  - For **Django 1.8**:\n\n    .. code-block:: python\n\n        urlpatterns = [\n            # ...\n            url(r'^shiny_apps/', include('cms_shiny.urls', namespace='cms_shiny')),\n            # ...\n        ]\n\n\nMigrations\n==========\n\nCreate and perform ``cms_shiny`` migrations:\n\n.. code-block:: sh\n\n    python manage.py makemigrations cms_shiny\n    python manage.py migrate\n\n\nUsage\n=====\n\n- Start the development server:\n\n.. code-block:: sh\n\n    python manage.py runserver\n\n\n- Visit: ``http://127.0.0.1:8000/``\n- Create a CMS page and then:\n\n  - Attach the ``Shiny Apps App`` under ``Advanced Settings`` for the page, **OR**\n  - Insert the ``Shiny App Plugin`` into a placeholder field.\n\n\n*Version 0.1.3*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmfcovington%2Fdjangocms-shiny-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmfcovington%2Fdjangocms-shiny-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmfcovington%2Fdjangocms-shiny-app/lists"}