Skip to main content

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.

Project description

django-multilingual-flatpages

https://secure.travis-ci.org/codesyntax/django-multilingual-flatpages.png?branch=master https://coveralls.io/repos/github/codesyntax/django-multilingual-flatpages/badge.svg?branch=master Code Health

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)

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)

0.7 (2017-04-05)

  • Basic test setup [erral]

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

0.6 (2017-01-20)

0.5 (2017-01-20)

0.4 (2016-11-29)

  • Nothing changed yet.

0.3 (2016-11-29)

  • Nothing changed yet.

0.2 (2016-11-29)

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

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

multilingual_flatpages-0.8.4.tar.gz (59.9 kB view hashes)

Uploaded Source

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