Metadata-Version: 2.1
Name: djangocms-scrape-google-photos-album
Version: 0.0.2
Summary: django-cms plugin to scrape a Google Photos public album link for photo urls.
Home-page: https://github.com/k-funk/djangocms-scrape-google-photos-album
Author: Kevin Funk
License: GPLv3+
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.11
Classifier: Framework :: Django CMS
Classifier: Framework :: Django CMS :: 3.5
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries
Description-Content-Type: text/markdown
Requires-Dist: Django (>=1.11)
Requires-Dist: django-cms (>=3.5)
Requires-Dist: requests (>=2.0)

djangocms-scrape-google-photos-album
=====================================

**djangocms-scrape-google-photos-album** is a plugin for [django CMS](<http://django-cms.org>) that
allows you to include a public google photo album in your site by way of scraping their html.

---

**WARNING: This is implementation is likely to break due to the nature of scraping. The regex will
need to be updated whenever google changes the structure of that page.**

---


Requirements
------------
* python 3.5+
* django 1.11 (other versions may work, but this is the only one that has been tested)
* django-cms 3.5 (other versions may work, but this is the only one that has been tested)


Installation
------------
```
pip install djangocms-scrape-google-photos-album
```


Usage
-----

Note: Results are cached for **30 minutes**. If this doesn't serve your needs,
[make an issue](https://github.com/k-funk/djangocms-scrape-google-photos-album/issues/new).

#### `settings.py`:
```
INSTALLED_APPS = (
    ...
    'djangocms_scrape_google_photos_album',
    ....
)
```

[Override the template](https://docs.djangoproject.com/en/3.0/howto/overriding-templates/)
included, as it's likely to not be the html that you want. Below is an example of how you could use
it with [Bootstrap 3](https://getbootstrap.com/docs/3.3/) and
[featherlight.js](https://noelboss.github.io/featherlight/).

#### `/my_project/templates/djangocms_scrape_google_photos_album/album.html`
```
{% if photo_urls %}
  <div class="container-fluid">
    <div class="row" data-featherlight-gallery data-featherlight-filter="a" data-featherlight-type="image">
      {% for photo_url in photo_urls %}
        <div class="col-xs-6 col-sm-4 col-md-3">
          <a href="{{ photo_url }}=w1200-h1200">
            <img src="{{ photo_url }}=w300-h300-c" class="img-responsive" />
          </a>
        </div>
      {% endfor %}
    </div>
  </div>
{% endif %}
```


