phpMyAdmin's website generator
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github
.well-known
data
demo
files
news
pmaweb
security
translations
.gitignore
.jshintrc
.landscape.yaml
.pep8
.travis.yml
README.rst
build.xml
codecov.yml
manage.py
pylint.rc
requirements-test.txt
requirements.txt

README.rst

Website for phpMyAdmin

Django code for phpMyAdmin's website.

https://travis-ci.org/phpmyadmin/website.svg?branch=master https://codecov.io/github/phpmyadmin/website/coverage.svg?branch=master https://api.codacy.com/project/badge/Grade/4cfc116f766947dcad6c006b295aafc2

Requirements

Python - https://www.python.org/
(2.7 tested)
Django - https://www.djangoproject.com/
(1.8.2 tested)
python-feedparser - https://github.com/kurtmckee/feedparser
(5.1 tested)
python-dateutil - https://labix.org/python-dateutil
(1.5 tested)

Security announcements and news

Edit announcements and news entries in the web UI.

Security issues are not publicly visible as long as they are marked as draft. The are accessible through separate URL (you can click View on the site link while editing).

Page generating

Each page has its own template. For most things it means inclusion of other templates to generate full page.

Menu

Menu is configured in data/menu.py, the first element always means page name second menu item title.

Themes

Themes require additional metadata, which is stored in data/themes.py.

Awards

All awards are listed in data/awards.py.

Screenshots

All screenshots are listed in data/screenshots.py.

Development

For development, first install dependencies. The ones needed for running the server are listed in requirements.txt, for running testsuite in requirements-test.txt. You can install them using your distribution (the package names will usually add python- prefix) or using pip:

pip install -r requirements-test.txt

You will need to apply migrations before loading test data:

./manage.py migrate

You might want to import some data to have at least some content on the website:

./manage.py loaddata pmaweb/fixtures/test_data.json

Once you have all dependencies, you can start development server:

./manage.py runserver

It will listed on port 8080 by default (you can change this by parameters).

To run testuite execute:

./manage.py test

Deployment

Cron jobs:

# Update translation stats
./manage.py fetch_translations
# Update planet posts
./manage.py fetch_planet

File releases scan:

# Import new releases from file storage
./manage.py import_files
# Import new themes from file storage
./manage.py import_themes

License

The website generator is licensed under GNU GPL version 2 or later.

Website itself uses some MIT licensed Javascript libraries:

The website content is licensed under Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License.