multilingual-flatpages 0.8.4

A flatpage is a simple object with a URL, title and content. Use it for one-off, special-case pages, such as “About” or “Privacy Policy” pages, that you want to store in a database but for which you don’t want to develop a custom Django application. A flatpage can use a custom template or a default, systemwide flatpage template. It can be associated with one, or multiple, sites. This version is a fork of django.contrib.flatpages package made it multilingual.

django-multilingual-flatpages

A flatpage is a simple object with a URL, title and content. Use it for one-off, special-case pages, such as “About” or “Privacy Policy” pages, that you want to store in a database but for which you don’t want to develop a custom Django application.

A flatpage can use a custom template or a default, systemwide flatpage template. It can be associated with one, or multiple, sites.

This version is a fork of django.contrib.flatpages package made it multilingual.

Installation

You will need to uninstall flatpages, and remove all traces of it from the INSTALLED_APPS and MIDDLEWARES settings.

To install the multilingual flatpages app, follow these steps:

1. Install this package:

   $ pip install multilingual_flatpages

2. Install the sites framework by adding ‘django.contrib.sites’ to your INSTALLED_APPS setting, if it’s not already in there.

3. Also make sure you’ve correctly set SITE_ID to the ID of the site the settings file represents. This will usually be 1 (i.e. SITE_ID = 1, but if you’re using the sites framework to manage multiple sites, it could be the ID of a different site.

4. Add ‘multilingual_flatpages’ and ‘hvad’ to your INSTALLED_APPS setting.

5. Add multilingual_flatpages.middleware.FlatpageFallbackMiddleware’ in your MIDDLEWARES list.

6. Add a TINYMCE_DEFAULT_CONFIG config option in your settings, for example:

   TINYMCE_DEFAULT_CONFIG = {
       'language': 'en',
       'theme': 'modern',
       'height': 600,
       'plugins': [
           'advlist autolink lists link image charmap print preview anchor',
           'searchreplace visualblocks code fullscreen',
           'insertdatetime media table contextmenu paste',
       ],
       'toolbar': 'styleselect | bold italic | alignleft aligncenter alignright alignjustify | bullist numlist outdent indent | link image media | code preview',
       'menubar': False,
       'media_alt_source': False,
       'media_poster': False,
       'media_dimensions': False,
   }

7. Add an entry in your URLconf. For example:

   from multilingual_flatpages import views as multilingual_flatpages_views
   ...
   urlpatterns = [
       url(r'^(?P<flatpage_slug>.*)$', multilingual_flatpages_views.flatpage, name='multilingual_flatpages'),
   ]

8. Run the command manage.py migrate.

Getting a URL of FlatPage object in your templates

The flatpages app provides a template tag that allows you to get the absolute url depending on your current language.

Like all custom template tags, you’ll need to load its custom tag library before you can use it. After loading the library, you can retrieve all current flatpages URL via the get_flatpage_url tag:

{% load flatpages %}

{% get_flatpage_url 'flatpage-name' %}

You can also use the get_flatpages template tag to get all the FlatPages:

{% load flatpages %}

{% get_flatpages as flatpages %}
<ul>
    {% for page in flatpages %}
        <li><a href="{{ page.get_absolute_url }}">{{ page.title }}</a></li>
    {% endfor %}
</ul>

Getting the URL of the translation of a FlatPage in your template

This is useful if you want to provide a language change link:

{% load flatpages %}
{% get_flatpages as flatpages %}
<ul>
    {% for page in flatpages %}
        <li><a href="{% get_translation_url page 'es'%}">{{ page.title }}</a></li>
    {% endfor %}
</ul>

CHANGELOG

0.8.4 (2020-06-29)

• setup fixed [Zaloa Etxaniz <[e-mail]>]

• [Mikel Larreategi <[e-mail]>]

• [ci skip] [Mikel Larreategi <[e-mail]>]

0.8.3 (2018-06-07)

• Fix setup.py [urtzai].

0.8.2 (2017-11-29)

• Fix install_requires [erral]

0.8.1 (2017-11-29)

• Convert README to RST [erral]

• Fix requirements.txt [erral]

0.8 (2017-04-07)

• fix translation url [Mikel Larreategi <[e-mail]>]

• [Mikel Larreategi <[e-mail]>]

• [ci skip] [Mikel Larreategi <[e-mail]>]

0.7 (2017-04-05)

• Basic test setup [erral]

• Add a template tag to get translated flatpages [erral]

0.6 (2017-01-20)

• fix manifest [Mikel Larreategi <[e-mail]>]

• delete MO files from git [Mikel Larreategi <[e-mail]>]

0.5 (2017-01-20)

• Update the item in urls.py [Mikel Larreategi <[e-mail]>]

• Merge pull request #3 from codesyntax/fixes [Urtzi Odriozola <[e-mail]>]

• [Urtzi Odriozola <[e-mail]>]

• Fixes: get_flatpages templatetag, middleware, default template [Urtzi Odriozola <[e-mail]>]

• provide a default template for multilingual flatpages [Mikel Larreategi <[e-mail]>]

• document how to use the get_flatpages templatetag [Mikel Larreategi <[e-mail]>]

• fix the get_flatpages templatetag [Mikel Larreategi <[e-mail]>]

• document how to enable the Fallback middleware [Mikel Larreategi <[e-mail]>]

• Merge pull request #2 from codesyntax/hvad [Urtzi Odriozola <[e-mail]>]

• [Urtzi Odriozola <[e-mail]>]

• add hvad installation to README [Urtzi Odriozola <[e-mail]>]

• add hvad installation to README [Mikel Larreategi <[e-mail]>]

• Merge pull request #1 from codesyntax/docs [Urtzi Odriozola <[e-mail]>]

• [Urtzi Odriozola <[e-mail]>]

• Docs improved [Urtzi Odriozola <[e-mail]>]

• document how to import the view [Mikel Larreategi <[e-mail]>]

• improve readme [Mikel Larreategi <[e-mail]>]

• add README and CHANGELOG as long_description to show on PYPI [Mikel Larreategi <[e-mail]>]

0.4 (2016-11-29)

• Nothing changed yet.

0.3 (2016-11-29)

• Nothing changed yet.

0.2 (2016-11-29)

• Preparing release 0.1 [Urtzi Odriozola <[e-mail]>]

0.1 (2016-11-29)

• hvad translation system

• tinymce 4.0.0 editor to the content field

• Renamed url field to slug

• Flatpage models, admin, forms to fit hvad translations in: title, content, slug