Package: django-yplaces
===============django-yplaces===============YPLACES == Yet/Why Another Django Places AppInstallation============1. Download dependencies:- Python 2.6+- Django 1.5+2. ``pip install django-yplaces`` or ``easy_install django-yplaces``Configuration=============settings.py-----------1. Add "yplaces" to your INSTALLED_APPS setting like this::INSTALLED_APPS = (# all other installed apps'yplaces',)2. Add logger handler::LOGGING = {'version': 1,'disable_existing_loggers': False,'handlers': {# all other handlers'log_file_yplaces': {'level': 'DEBUG','class': 'logging.handlers.RotatingFileHandler','filename': os.path.join(os.path.join(os.path.dirname( __file__ ), '..'), 'logs/yplaces.log'),'maxBytes': '16777216', # 16megabytes},},'loggers': {# all other loggers'yplaces': {'handlers': ['log_file_yplaces'],'propagate': True,'level': 'DEBUG',}}}3. Configure YPLACES's settings::YPLACES = {# API URL Namespace (e.g. YPLACES URL is in /api/v1, and the respective Django URL namespaces are 'api' and 'v1')'api_url_namespace': 'api:v1',# Details on the sender of any emails sent by YPlaces.'email_from': { 'name': 'John Doe', 'email': 'john@example.com' },# Emails of the admins that receive certain emails (e.g. Place waiting to be reviewed)'admin_emails': [{ 'name': 'BOFH', 'email': 'bofh@foobar.com' }],# The title to be displayed in the app's index page and respective description.'index_title': 'My Awesome App','index_description': 'This is a very awesome app where you can find anything!'}4. Don't forget to set the 'MEDIA_URL' variable, which defines the root folder to where files will be uploaded (e.g. profile pictures) and thevariable necessary for the full URL's of the pictures to be built::MEDIA_ROOT = os.path.join(BASE_DIR, 'static/uploads/')MEDIA_URL = HOST_URL + '/static/uploads/'5. Configure template processors so tha every RequestContext will contain a variable request, which is the current HttpRequest. This will be used for stuffsuch as knowing the current path.from django.conf.global_settings import TEMPLATE_CONTEXT_PROCESSORS as TCPTEMPLATE_CONTEXT_PROCESSORS = TCP + ('django.core.context_processors.request',)6. In order to enable sitemap.xml generator for places, make sure the respective django app is installed in 'INSTALLED_APPS':'django.contrib.sitemaps'Logs----Create a 'logs' folder in your project's root folder (if you don't have one already).Your project folder should look something like this::myproject/__init__.pysettings.pyurls.pywsgi.pylogs/manage.pyDatabase--------Run ``python manage.py syncdb`` to create the yplaces models.URLs----1. Add app URL namespace to top-level ``urls.py``::# myproject/urls.py# ============from yplaces.sitemap import PlaceSitemapsitemaps = {# any other sitemaps'restaurants': PlaceSitemap}urlpatterns = patterns('',# all other url mappings# Place's Sitemap.url(r'^sitemap\.xml/?$', 'django.contrib.sitemaps.views.sitemap', { 'sitemaps': sitemaps }, name='sitemap'),# Place's Pages.url(r'^places', include('yplaces.urls', namespace='yplaces')),)2. Add app to API namespace::# myproject/api/urls.py# ============urlpatterns = patterns('',# all other api url mappingsurl(r'^/places', include('yplaces.api.urls', namespace='yplaces')),)