README.md

ran-django-template

Feature

For Site

• Create Django web server in local
• Gallery and carousel control in home page
• Beautify site admin interface
• Restful API for IOT control
• Oauth2.0 for third party account login，such as: Github
• QR code generator
• PC, Mobile auto adaptation
• Support Font awesome, django-jet, Bootstrap, Animate.css

For Blog

• Rich text editor
• Article management and counting, including adding, deleting and editing
• Tag management, including adding, deleting and editing
• Classified management, including adding, deleting and editing
• Read more

Documentation

Add INSTALLED_APPS setting:

    INSTALLED_APPS = [
		'jet.dashboard', #  before your django admin
		'jet',	#  before your django admin
	    	'apps.gallery.apps.GalleryConfig',
		'allauth',
		'allauth.account',
		'allauth.socialaccount',
		'allauth.socialaccount.providers.github',
		'myauth',
		'widget_tweaks',
		'werkzeug_debugger_runserver',
		'django_extensions',
		'rest_framework',
		'apps.myapp',
		'apps.blogs',
		'apps.qrcreate',
		'apps.blog',    # Blog for new version
		'django_summernote',
    ]

How to run it

git clone https://github.com/nature1995/ran-django-template.git

cd ran-django-template
pip install -r requirements.txt
python manage.py makemigrations
python manage.py migrate
python manage.py runserver 0.0.0.0:8000

Access the web page though this link: http://0.0.0.0:8000/

Compatibility

The codes are tested using Travis-CI platform with django 2.1.5 and Python 3.5, 3.6, 3.7.

Django\Python	3.5	3.6	3.7
2.0.x	*	*	*
2.1.x	*	*	*
3.0.0	*	*	*

Notice:

1. Because the jet admin do not support django==3.0.0. Please remove jet in setting.py and urls.py, if you would like to use django == 3.0.0

2. Django 2.1.x need to using the following change:**

If you have the ERROR message with render() got an unexpected keyword argument 'renderer'；, please find Python folder: \lib\site-packages\django\forms\boundfield.py. Then, comment the as_widget, line 93, like the follow:

return widget.render(
	name=self.html_initial_name if only_initial else self.html_name,
	value=self.value(),
	attrs=attrs,
	# renderer=self.form.renderer,
)

Demo

Web Page: https://ranxiaolang.com or https://www.zran.xyz

Site Admin installation

Add 'jet.dashboard' application to the INSTALLED_APPS setting of your Django project settings.py file (note it should be before 'jet'):

INSTALLED_APPS = (
    ...
    'jet.dashboard',  # before your django admin
    'jet',  # before your django admin
    'django.contrib.admin',
    ...
)

Add URL-pattern to the urlpatterns of your Django project urls.py file (they are needed for related–lookups and autocompletes): before 'jet'):

urlpatterns = patterns(
    ...
    path(r'admin/', admin.site.urls),
    path('jet/', include('jet.urls', 'jet')),  # Django JET URLS
    path('jet/dashboard/', include('jet.dashboard.urls', 'jet-dashboard')),  # Django JET dashboard URLS
    ...
)
before 'jet'):

For Google Analytics widgets only install python package:

pip install google-api-python-client==1.4.1

Create database tables:

python manage.py migrate dashboard
# or
python manage.py syncdb

Collect static if you are in production environment: before 'jet'):

python manage.py collectstatic

Others

Admin Account

python manage.py createsuperuser

username: ranxiaolang
email: YOUR EMAIL  
password: ranxiaolang  

Access the web page though this link: http://0.0.0.0:8000/admin

Django Restframework
Access the web page though this link: http://0.0.0.0:8000/iot/

TODO

• Add more social Oauth2.0
• Add comment
• Add site map

Author

• Ziran Gong - Web Page

License

This software is licensed under the GNU General Public License v3.0 License. For more information, read the file LICENSE.
Just can be used for non-business projects.