Metadata-Version: 2.4
Name: django_presskit
Version: 1.4.2
Summary: A port of presskit() to Django
Home-page: https://github.com/FutureProofGames/django-presskit.git
Author: Future Proof Games
Author-email: info@futureproofgames.com
Classifier: Programming Language :: Python :: 3.8
Classifier: Framework :: Django :: 3.2
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: summary

# django-presskit
A port of Rami Ismail's [presskit()/dopresskit](https://github.com/ramiismail/dopresskit) to Django.

[![django-presskit CI](https://github.com/FutureProofGames/django-presskit/actions/workflows/main.yaml/badge.svg)](https://github.com/FutureProofGames/django-presskit/actions/workflows/main.yaml) [![Coverage Status](https://coveralls.io/repos/github/FutureProofGames/django-presskit/badge.svg?branch=develop)](https://coveralls.io/github/FutureProofGames/django-presskit?branch=develop)

## Installing

### Requirements:

* Django>=3.2
* django-filer>=3.3.0
* easy_thumbnails==2.9 
* Markdown>=2.6.11
* Pillow>=10.3.0
* django-admin-sortable2>=1.0.4
* future>=0.18.3

## Configuring

Add "django_presskit" and "adminsortable2" to your settings.py INSTALLED_APPS.

Add `DJANGO_PRESSKIT_DEFAULT_COMPANY_ID = 1` to your settings file.

In your main urls.py, add a line like: `url(r'^presskit/', include('django_presskit.urls', namespace='django_presskit')),`

All data can be set up in the Django admin.

## Upgrading

If upgrading to 1.1.0, run the following on your project after adding `adminsortable2` to your settings:

```
python manage.py reorder django_presskit.additionallink django_presskit.award django_presskit.companyimageattachment django_presskit.companylogoattachment django_presskit.companyvideo django_presskit.contact django_presskit.credit django_presskit.feature django_presskit.platform django_presskit.price django_presskit.project django_presskit.projectimageattachment django_presskit.projectlogoattachment django_presskit.quote django_presskit.social django_presskit.trailer
```

## Converting from presskit()/dopresskit

If you are switching from Rami Ismail's presskit(), you'll want to make sure any old URLs that are floating around continue to work. Presskit() URLs look like `/presskit/sheet.php?p=exploit_zero_day`. You'll want to convert those into something like `/presskit/exploit-zero-day/`.

Make sure that the slugs for your django-presskit projects match those for your presskit() projects. Then, you can use URL rewriting to redirect users to the new URL.

If you have Apache with mod_rewrite enabled, add something like the following to your `.htaccess` file:

```
RewriteEngine  on
RewriteCond %{QUERY_STRING} ^p=(.*)$
RewriteRule "^/?presskit/sheet.php"  "/presskit/projects/%1" [N]
# Repeatedly remove underscores until only one is left.
RewriteRule "^(/?presskit/projects/.*)_(.*_.*)$"  "$1-$2" [N]
# Redirect with the last underscore rewrite.
RewriteRule "^(/?presskit/projects/.*)_(.*)$"  "$1-$2" [R=301]
RewriteRule "^/?presskit/sheet\.php$ "              "/presskit/" [R=301]
```

**Note**: If you are running python through Passenger (as one does on Dreamhost hosting, for instance), these rewrite rules will likely not work, as Passenger does additional processing of URLs.

If you're using nginx for rewrites, this would look like:

```
location ~* /presskit/sheet.php {
    if ($args ~* "^p=(\d+)") {
        set $proj $1;
        set $args '';
        rewrite ^.*$ /presskit/projects/$proj permanent;
    }
}
# Remove up to 10 underscores until none are left.
rewrite ^(/?presskit/projects/.*?)_(.*)$  $1-$2 last
rewrite ^/?presskit/sheet\.php$           /presskit/ permanent
```
If you're using nginx and one of your slugs has more than ten underscores, add a rewrite above the first one to manually fix that one case. Nginx does not want to loop more than 10 times in a rewrite calculation.


## Changelog

### 1.4.2

* Minor version bumps to Django, pillow, and filer for security

### 1.4.1

* Update various python packages: Pillow, future, django (still 3.2)
* Add Github builds to replace old Travis CI builds, including code coverage

### 1.4.0
* Update requirements to Python 3.8 and Django 3.2
* Remove support for Django 2.1, which ended official support in 2021
* Update to support changes in django-admin-sortable
* Add DPK version number to footer
* Clean up unnecessary imports in views

### 1.3.1
* Upgrade packages

### 1.3.0

* Add support for Django 2 and 3, drop support for Django 1

### 1.2.0

* Upgrade to support Python 3.6+
* Bump to Pillow 6.2.0
* Bump to Django 1.11.23

## Contributing

When submitting issues or pull requests, please adhere to our [Code of Conduct](CODE_OF_CONDUCT.md).
