Package: nexus-yplan
NexusRetired: this project is no longer maintained.I (Adam Johnson) no longer
have time to continue maintaining this. I was doing so to supportgargoyle-yplan, a fork for my
ex-employer YPlan. If you’d like to sponsor ongoing maintenance or take it over
yourself, please contactme@adamj.eu.Nexus is a pluggable admin application in Django. It’s designed to give you a simple design and architecture for
building admin applications.It was originally created byDisqus, but due to the inactivity we at YPlan have taken over maintenance on this fork.ScreenshotRequirementsTested with all combinations of:Python: 3.6Django: 1.11, 2.0, 2.1, 2.2Python 3.4+ supported.InstallationInstall it withpip:pipinstallnexus-yplanMake sure youpip uninstall nexusfirst if you’re upgrading from the original to this fork - the packages clash.You’ll need to enable it much like you woulddjango.contrib.admin.First, add it to yourINSTALLED_APPSsetting:INSTALLED_APPS=(...'nexus',)nexushas three dependencies from core Django -django.contrib.admin,django.contrib.auth, anddjango.contrib.sessions. If these applications are not in yourINSTALLED_APPS, add them; or if you are using a
custom auth system you can skip these requirements by adding the lineNEXUS_SKIP_INSTALLED_APPS_REQUIREMENTS = Trueto your settings.Second, include nexus at some url in yoururls.py:importnexus# urls.pyurlpatterns=patterns('',('^nexus/',include(nexus.site.urls)),)Nexus has autodiscovery similar to Django Admin - it will look in each of yourINSTALLED_APPSfor anexus_modulessubmodule, and import that. This is where the app should declare aNexusModulesubclass and usenexus.site.registerto add it to the main Nexus site. Thus to add functionality you should install some packages
with modules, or write your own.Available ModulesThe following modules are tested againstnexus-yplan:Gargoyle (YPlan fork)There are also some older applications that provide Nexus modules, however these were only developed against Disqus’
Nexus and not this fork; your mileage may vary:nexus-memcachenexus-redisIf you want to write a module, there are a couple of example modules intests/testapp/nexus_modules.py, with
templates intests/testapp/templates/nexus/example. Also the source code shouldn’t be too hard to understand.A Note on LoginUntil Version 1.1, Nexus included a login/logout functionality. Unfortunately these were copied and adapted from an old
version of the code in Django Admin, and were thus not up to date with security changes in newer Django versions. Since
keeping them up to date would be a burden, and most sites use Django Admin for adminstrator login, the login/logout
functions have been removed.Nexus now relies on Django Admin login, or for users to visit it having logged in through another route.SettingsNexus’ behaviour can be customized by adding some values to your Django settings.MediaBy default Nexus serves its media files itself through Python, avoiding any configuration to integrate with your
project. This is convenient but can be slow. You can control where the media files are served from with the settingNEXUS_MEDIA_PREFIX, for example:NEXUS_MEDIA_PREFIX='/served/here/'This will make Nexus write its media URLs using this prefix, where it assumes you have set up serving its files.HistoryPending Release2.1.2 (2019-05-17)Retired: this project is no longer maintained.I (Adam Johnson) no longer
have time to continue maintaining this. I was doing so to supportgargoyle-yplan, a fork for my
ex-employer YPlan. If you’d like to sponsor ongoing maintenance or take it
over yourself, please contactme@adamj.eu.2.1.1 (2019-04-28)Tested on Django 2.2. No changes were needed for compatibility.2.1.0 (2019-04-14)Drop Django 1.8, 1.9, and 1.10 support. Only Django 1.11+ is supported now.2.0.0 (2019-03-02)Drop Python 2 support, only Python 3.4+ is supported now.1.6.1 (2018-10-17)Fix Django deprecation warnings1.6.0 (2017-10-28)Added Django 2.0b1 supportTested on Django 1.11 (no changes were necessary)1.5.0 (2017-01-19)Added CSRF token on the base template to make AJAX requests work when Django’sCSRF_COOKIE_HTTPONLYsetting is
setRemoved the now obsolete template tagnexus_csrf_cookie_name1.4.0 (2016-05-24)Fixed footer appearance on long pagesFixed the tab highlighting and removedNexusModule.get_requestwhich existed only to support the old broken code.‘jQuery Templates’ is no longer included in Nexus - this was done for Gargoyle, which now uses its own bundled
templating code instead.1.3.1 (2016-02-25)Theme updated a bit more to make buttons look nice1.3.0 (2016-02-24)New Logo and theme, thanks @emache.The login logic no longer sends users without permission to see Nexus through a redirect loop, thanks @ChunYin for
the report.1.2.0 (2016-02-12)Removed support for Django 1.7Removed the need to add a call tonexus.autodiscover()in your URLConf by using theAppConfig, similar to
Django Admin from Django 1.7+Upgraded jQuery to 1.6.4Upgraded Facebox to its master version1.1.0 (2016-01-13)Removed support for old Django versionsFixed all deprecation warnings on Django 1.7 and 1.8Added Django 1.9 supportAdded Python 3.4 and 3.5 supportHistorically Nexus had a module that embedded Django Admin; this has not worked since Django 1.3 due to removal of
theadminmediatemplate tag that the templates were still using. Because it seems that no one has been using it,
it has been removed. Users are encourage to just use the normal Django Admin instead. Nexus thus ships with no
modules included.Removed the login/logout pages, which were copied and adapted from an old version of Django Admin, and likely no
longer secure. If you are not logged in Nexus will now redirect you to Django Admin - thus Django Admin is now
required by Nexus.Fixed Nexus CSRF protection to work if you have changed the CSRF cookie name,
thanks to a PR on the original Nexus from Github users @karech and
@graingert.Removed all inline javascript, thanks @graingert.1.0.0 (2015-12-09)First publication on PyPI asnexus-yplanDjango 1.8 compatibility0.3.1 (2015-01-22)Better support for Django 1.7 and Python 30.2.3 (2011-12-19)Ensure on exempt views we still send .Downgrade CSRF ajax to work with older versions of jQuery.0.2.2 (2011-12-19)Update AJAX CSRF set to work against correct origins.0.2.1 (2011-12-19)Added version to Nexus footer.