Jmbo foundry behaviour/templates app.
Project description
Jmbo Foundry User Guide
jmbo-foundry ties together the various jmbo products enabling you to rapidly build multilingual web and mobi sites with the minimum amount of code and customization.
jmbo-foundry strives for a high level of through the web configuration. Much of the site’s behaviour is configurable through the admin interface.
Sites
Your web presence typically consists of a normal web site and a mobile site. There may be many more types of sites in future and jmbo-foundry makes it easy to configure them independently. If your main site is served on www.mysite.com then go to Sites in the admin interface and set Domain name and Display name accordingly. Then add a site entry for your mobile site and set the values to m.mysite.com.
If you have only one site then you may blindly publish everything that is publishable to this site. However, if you have more than one site and in different languages then understanding sites become significant.
At its most basic level publishing to a site means making content appear on a site. This is easy to understand when the content is eg. an article, but content is not always limited to things which are easily translatable into real world objects.
Preferences
Preferences can be published to certain sites.
General preferences
Check Private site to make the site accessible only to visitors who are logged in.
Check Show age gateway to enable the age gateway for the site. Visitors must confirm their age before they are allowed to browse the site.
Exempted URLs are URLs which must always be visible regardless of Private site or Age gateway settings. Certain URLs like /login are visible by default and do not need to be listed.
The Analytics tags field may contain javascript. There is a fallback to enable analytics on low-end browsers but it is not configurable through the web. See the settings.py section.
Registration preferences
You can select which fields to display on the registration form. Some fields (eg. username) are always visible on the registration form and cannot be removed.
You can select a subset of the displayed fields to be required. Fields which are absolutely required (eg. username) cannot be set to be optional. For instance, if the site users my log in using their mobile number then set mobile_number as a required field.
Some fields may need to be unique, especially those that may be used to log in to the site. Using the mobile number example above you should set mobile_number to be a unique field. It is important to decide beforehand which fields must be unique since it is difficult to remove duplicates if you change this setting. An exeption is raised if you attempt to change this setting and duplicates are detected (friendlier validation still to be added).
Login preferences
Users typically log in to a normal site with their username or email address, whereas a mobile number is a natural login field for a mobile site. Choose from Username only, Email address only, Mobile number only or Username or email address.
Password reset preferences
When a user loses his password he may request a password reset. Normally this is accomplished by sending an email to the user, but in the case of a mobile site it is desirable to send a text. Choose between Email address or Mobile number. Note that a password reset request does not automatically generate a new password for the user since this may lead to malicious people disabling users’ accounts.
Naughty word preferences
You can set a list of weighted words. The report_naughty_words management command identifies potentially offensive comments. An email containing clickable links for approval or deletion is sent to the Email recipients.
Listings
A listing is essentially a stored search that can be rendered in a certain style. A listing can be published to certain sites.
Content type, Category and Content are criteria which define the items present in the listing. These criteria are mutually exclusive.
Count specifies the maximum number of items in the listing.
Style is the default way in which the listing is rendered. The styles are vertical, vertical, vertical thumbnail, horizontal, promo and widget. See Listing styles for detail.
Items per page is the number of items to display on a single listing page.
Listing styles
Vertical is a vertical listing with no images.
Vertical thumbnail is a vertical listing with images.
Horizontal is a side-by-side listing with images. Each item looks like a baseball trading card.
Promo collates the items in a slideshow.
Widget is the most complex. It is used when each item can be interactive, eg. a listing of polls. Polls you have already voted on are read-only, and the others may change content once you vote on them. The content type being represented as a widget needs to provide code for this functionality.
Links
A link is a re-usable pointer to something, be it inside the site or external.
URL, Category, View name and Target fields are mutually exclusive.
View name warrants further explanation. It is the name of a named Django view, eg. contact-us. The vocabulary is all the named views in the Django site excluding those with a variable parameter.
Pages
Page builder documentation tbc. Authors =======
Praekelt Foundation
Shaun Sephton
Hedley Roos
Euan Jonker
Rizmari Versfeld
Changelog
0.2.2
Pin django-ckeditor to >= 3.6.2
Remember me field now on login and join forms. Checked by default.
Any call to get_XXX_url is now layer aware.
Comment posting now ajaxified depending on browser capabilities.
0.2.1
Remove dependency links.
0.2
Add a base_inner.html template so it is easier to override base.html.
Patch listdir so collectstatic does not fail on custom layers for third party foundry-based products.
0.1
Use Jaro Winkler for matching naughty words.
0.0.2 (2011-09-27)
Detail view.
Element preferences.
0.0.1 (2011-09-21)
Initial release.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
File details
Details for the file jmbo-foundry-0.2.2.tar.gz.
File metadata
- Download URL: jmbo-foundry-0.2.2.tar.gz
- Upload date:
- Size: 427.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 51d2b9586ebd88c72399c674609249edca42ef4b55256b9305836bbbfd0ff429 |
|
| MD5 | e1cc5b3a28f5f5e58f9383d6cedeab54 |
|
| BLAKE2b-256 | 2c75bca9b750a3a17767ec869ec1842aa8e1ef5246da9df02a9e660578e1cd6d |
Provenance
File details
Details for the file jmbo_foundry-0.2.2-py2.7.egg.
File metadata
- Download URL: jmbo_foundry-0.2.2-py2.7.egg
- Upload date:
- Size: 659.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 915d121414d8bb43cfc34bfadbc9612fa81094501c201ab460df958688f0015f |
|
| MD5 | 962ca843be98dc4e5ac76197c19f3a7f |
|
| BLAKE2b-256 | 49eedf3daa39b6bcc41e319f37f16cfd66940ace5964a5afb979f801297ff3cb |
Provenance
File details
Details for the file jmbo_foundry-0.2.2-py2.6.egg.
File metadata
- Download URL: jmbo_foundry-0.2.2-py2.6.egg
- Upload date:
- Size: 659.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 28bbaf46c5aa62a6dacf77fa187bd234bf4385e5fb2b301c5675b8fd5dbe8739 |
|
| MD5 | 8b79038cda10233eb76f22cef7893ad2 |
|
| BLAKE2b-256 | 66da3439690eec6e95b28cde6e0a3651cd7745f4ef5aa1ff5e9dbc38b2a46b2b |
