{ "info": { "author": "Isaac Bythewood", "author_email": "isaac@bythewood.me", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Environment :: Web Environment", "Framework :: Django", "Intended Audience :: Developers", "License :: OSI Approved :: BSD License", "Operating System :: OS Independent", "Programming Language :: Python" ], "description": "# django-locator\n\nAn easy to integrate store locator plugin for Django.\n\n\n## Setup\n\n 1. Run `pip install django-locator`.\n 2. In `settings.py` add `locator` to the `INSTALLED_APPS`.\n 3. In `urls.py` add `url(r'^locator/', include('locator.urls', namespace='locator'))` to the `urlpatterns`.\n 4. Run `manage.py syncdb`.\n\n\n## Using the template tag\n\ndjango-locator is easy to include in your templates, you just need to do two\nthings:\n\n 1. Include the CSS and JS files on the page you're wanting to use django-locator.\n 2. Load the django-locator template tag and insert it where you want it to show up.\n\n### Including the CSS and JS files\n\nThere is one CSS file, place this line in your HTML header with the rest of your\nCSS imports:\n\n \n\nThe JS is slightly more complex, first, make sure you don't already have jQuery,\nif you don't have jQuery then add this to the bottom of your HTML file but still\ninside your `` tag:\n\n \n\nOnce you have jQuery you now need the Google Maps API JS files:\n\n \n\nClose to the end! Now include the store locator JS file below both of these\nimports:\n\n \n\nLastly we need to initialize the store locator script by putting this at the\nvery bottom below the imports we just made:\n\n \n\n### Loading the template tag\n\nOnce you have the CSS and JS included the template tag is easy, add\n`{% load locator %}` to the top of your template and then put `{% locator %}`\nwhere you want the locator to show up on your page.\n\n\n## Customizing\n\nYou can of course override everything in my CSS file easily by importing your\nown CSS file below it or copying my CSS file, making changes to it and then\nimporting your changed CSS file instead of my own.\n\nAlong with the basic CSS customizing see [Bjorn's blog post][0] about how you can\nmodify our JavaScript initilizer to further customize your experience.\n\n\n## Notes\n\nI include an `initial_data.json` fixture to load in a few example items, you can\neasily mass delete them on the admin interface.\n\nTo access my \"test\" template you can append `/locator/` to your base URL. All of\nthe locations are pulled via JSON from the URL `/locator/locations/` if you want\nto use this data for anything else.\n\n\n## Credits\n\nGive all your thanks to [Bjorn][1] who created the [jQuery plugin][0] we make extensive\nuse of in this app.\n\n\n## License (Simplified BSD)\n\nCopyright (c) Isaac Bythewood \nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are met:\n\n1. Redistributions of source code must retain the above copyright notice,\n this list of conditions and the following disclaimer.\n\n2. Redistributions in binary form must reproduce the above copyright notice,\n this list of conditions and the following disclaimer in the documentation\n and/or other materials provided with the distribution.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND\nANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED\nWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE\nDISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR\nANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES\n(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;\nLOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND\nON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS\nSOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n\n[0]: http://www.bjornblog.com/web/jquery-store-locator-plugin\n[1]: http://www.bjornblog.com/", "description_content_type": null, "docs_url": null, "download_url": "http://github.com/overshard/django-locator/downloads", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://github.com/overshard/django-locator", "keywords": null, "license": "Simplified BSD", "maintainer": null, "maintainer_email": null, "name": "django-locator", "package_url": "https://pypi.org/project/django-locator/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/django-locator/", "project_urls": { "Download": "http://github.com/overshard/django-locator/downloads", "Homepage": "http://github.com/overshard/django-locator" }, "release_url": "https://pypi.org/project/django-locator/1.0.0/", "requires_dist": null, "requires_python": null, "summary": "An easy to integrate store locator plugin for Django.", "version": "1.0.0" }, "last_serial": 521088, "releases": { "1.0.0": [ { "comment_text": "", "digests": { "md5": "afd00d34c02f647e2dc63148bf8bc5f3", "sha256": "25909fad0d225748658e779fa270573137ef321fe92e48a21e76fd8dc94424a3" }, "downloads": -1, "filename": "django-locator-1.0.0.tar.gz", "has_sig": false, "md5_digest": "afd00d34c02f647e2dc63148bf8bc5f3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14895, "upload_time": "2012-12-05T05:26:23", "url": "https://files.pythonhosted.org/packages/8f/6c/bc286b7da761b793b1cbb57cc7649268641cb68377f40e7604f25be834a5/django-locator-1.0.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "afd00d34c02f647e2dc63148bf8bc5f3", "sha256": "25909fad0d225748658e779fa270573137ef321fe92e48a21e76fd8dc94424a3" }, "downloads": -1, "filename": "django-locator-1.0.0.tar.gz", "has_sig": false, "md5_digest": "afd00d34c02f647e2dc63148bf8bc5f3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14895, "upload_time": "2012-12-05T05:26:23", "url": "https://files.pythonhosted.org/packages/8f/6c/bc286b7da761b793b1cbb57cc7649268641cb68377f40e7604f25be834a5/django-locator-1.0.0.tar.gz" } ] }