Skip to main content

Adds blogging abilities to django CMS

Project description

Simple blogging application. It allows you to:

  • write a tagable post message

  • plug in latest post messages (optionally filtered by tags)

  • attach post message archive view

Installation

Aldryn Platform Users

Choose a site you want to install the add-on to from the dashboard. Then go to Apps -> Install app and click Install next to Blog app.

Redeploy the site.

Manual Installation

NOTE: If you are using a database other than PostgresSQL, check out the table below.

Database support:

SQLite3

MySQL

PostgresSQL

Not supported

Requires Time zone support

Fully supported

Run pip install aldryn-blog.

Add below apps to INSTALLED_APPS:

INSTALLED_APPS = [
    …

    'aldryn_blog',
    'aldryn_common',
    'django_select2',
    'djangocms_text_ckeditor',
    'easy_thumbnails',
    'filer',
    'taggit',
    # for search
    'aldryn_search',
    'haystack',
    …
]

Posting

You can add post messages in the admin interface now. Search for the label Aldryn_Blog.

In order to display them, create a CMS page and install the app there (choose Blog from the Advanced Settings -> Application dropdown).

Now redeploy/restart the site again.

The above CMS site has become a blog post archive view.

About the Content of a Post

In Aldryn Blog, there are two content fields in each Post which may be confusing:

  1. Lead-In and

  2. Body

The Lead-In is text/html only and is intended to be a brief “teaser” or introduction into the blog post. The lead-in is shown in the blog list-views and is presented as the first paragraph (or so) of the blog post itself. It is not intended to be the whole blog post.

To add the body of the blog post, the CMS operator will:

  1. Navigate to the blog post view (not the list view);

  2. Click the “Live” button in the CMS toolbar to go into edit-mode;

  3. Click the “Structure” button to enter the structure sub-mode;

  4. Here the operator will see the placeholder “ALDRYN_BLOG_POST_CONTENT”, use the menu on the far right of the placeholder to add whatever CMS plugin the operator wishes –– this will often be the Text plugin;

  5. Double-click the new Text plugin (or whatever was selected) to add the desired content;

  6. Save changes on the plugin’s UI;

  7. Press the “Publish” button in the CMS Toolbar.

Available CMS Plug-ins

  • Latest Blog Entries plugin lets you list n most frequent blog entries filtered by tags.

  • Blog Authors plugin lists blog authors and the number of posts they have authored.

  • Tags plugin lists the tags applied to all posts and allows filtering by these tags.

Additional Settings

  • ALDRYN_BLOG_SHOW_ALL_LANGUAGES: By default, only the blog posts in the current language will be displayed. By setting the value of this option to True, you can change the behaviour to display all posts from all languages instead.

  • ALDRYN_BLOG_USE_RAW_ID_FIELDS: Enable raw ID fields in admin (default = False)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aldryn-blog-0.4.4.tar.gz (27.2 kB view details)

Uploaded Source

Built Distribution

aldryn_blog-0.4.4-py2-none-any.whl (65.9 kB view details)

Uploaded Python 2

File details

Details for the file aldryn-blog-0.4.4.tar.gz.

File metadata

  • Download URL: aldryn-blog-0.4.4.tar.gz
  • Upload date:
  • Size: 27.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for aldryn-blog-0.4.4.tar.gz
Algorithm Hash digest
SHA256 920fe4083955ac90d16b01ac1a351bef96f13db53e9ef9d0bab4515fc0fcfbd2
MD5 ab09d2b9a34fe24f6d4d64c24bb0df75
BLAKE2b-256 95e3fb3521ec07b756f1d939dbb40160f1a6991d6fdd05c8479047a4f95aef67

See more details on using hashes here.

File details

Details for the file aldryn_blog-0.4.4-py2-none-any.whl.

File metadata

File hashes

Hashes for aldryn_blog-0.4.4-py2-none-any.whl
Algorithm Hash digest
SHA256 caacd8a178e6edb8e17ba50067de10ac45b0998f9fb79b23e98c87a7bb0e0d75
MD5 28ecf01300ae07ebbcd2fd299a83cca2
BLAKE2b-256 78c94d0c2605b9e589cefc60a672e3f2343f46d6b54b69ab2bba622ba764c5ec

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page