https://github.com/blueshoe/djangocms-hubspot-blog
A djangoCMS App which imports blog posts from the Hubspot Content API :newspaper:
https://github.com/blueshoe/djangocms-hubspot-blog
blog django django-cms hubspot hubspot-api
Last synced: 4 months ago
JSON representation
A djangoCMS App which imports blog posts from the Hubspot Content API :newspaper:
- Host: GitHub
- URL: https://github.com/blueshoe/djangocms-hubspot-blog
- Owner: Blueshoe
- License: mit
- Created: 2018-05-04T13:32:08.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-05-14T15:11:45.000Z (over 7 years ago)
- Last Synced: 2025-05-25T09:15:45.435Z (5 months ago)
- Topics: blog, django, django-cms, hubspot, hubspot-api
- Language: Python
- Homepage:
- Size: 46.9 KB
- Stars: 6
- Watchers: 6
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.rst
- License: LICENSE.txt
Awesome Lists containing this project
README
.. image:: https://badge.fury.io/py/djangocms-hubspot-blog.svg
:target: https://badge.fury.io/py/djangocms-hubspot-blog
==================================
djangoCMS Hubspot Blog Integration
==================================
- Imported enitites: Authors, Topics and Posts are stored into the database
- djangoCMS App to hook views into the page (list, detail, topics-list, author-list)
- Import can be triggered by multiple ways (management command, admin, call to the api module)
Installation
==================================
- ``pip install djangocms-hubspot-blog``
- Add the app ``djangocms_hubspot_blog`` to your ``INSTALLED_APPS``
- Add the settings listed below to your settings file
- Override the templates listed below (optional but recommended)
How to fetch blog posts
==================================
**Automatically**
The best aproach is to **automatically** fetch posts, authors and topics by
periodically running the management command ``import_blog_posts`` via CRON
or calling ``djangocms_hubspot_api.update_blog_posts()`` from a task queue.
**Manually**
You can either use the management command ``import_blog_posts`` or update all entities via a button in the admin of the blog posts.
Settings
==================================
+-------------------------+----------+---------------+
| Setting Name | Required | Default Value |
+=========================+==========+===============+
| HUBSPOT_API_KEY | yes | / |
+-------------------------+----------+---------------+
| HUBSPOT_BLOG_ID | yes | / |
+-------------------------+----------+---------------+
| PORTAL_ID | yes | / |
+-------------------------+----------+---------------+
| HUBSPOT_BLOG_PAGE_LIMIT | no | 10 |
+-------------------------+----------+---------------+
Views & Templates
==================================
It's recommended to override the given templates. Take a look at the templates on how to do it.
+------------------------+---------------------------------------------+--------------------------------------------+
| View | View Name | Template |
+========================+=============================================+============================================+
| HubspotPostsList | ``djangocms_hubspot_blog:posts-list`` | ``djangocms_hubspot_blog/post_list.html`` |
+------------------------+---------------------------------------------+--------------------------------------------+
| HubspotTopicList | ``djangocms_hubspot_blog:topic-list`` | ``djangocms_hubspot_blog/post_list.html`` |
+------------------------+---------------------------------------------+--------------------------------------------+
| HubspotAuthorPostsList |``djangocms_hubspot_blog:author-posts-list`` | ``djangocms_hubspot_blog/post_list.html`` |
+------------------------+---------------------------------------------+--------------------------------------------+
| HubspotPostDetail | ``djangocms_hubspot_blog:post-detail`` | ``djangocms_hubspot_blog/post_detail.html``|
+------------------------+---------------------------------------------+--------------------------------------------+
The pagination has an additional partial template at ``djangocms_hubspot_blog/partials/pagination.html``
Missing Functionality
==================================
- Localization (Currently it's German only)
Contributing
==================================
You're welcome to submit Pull Requests! :rocket:
Just take a look at the open issues.