ModelBase

Jmbo itself has no content type. For our purposes assume a trivial content type called Trivial Content which subclasses ModelBase.

1. Title is self-explanatory.

2. Subtitle is an optional field that is only visible in the admin interface. If you have two items with the same title (a common case in multilingual sites) then add extra text in the subtitle to distinguish between the items.

3. Description is an optional field. It is good practice to set it since sites like Facebook read it when content is shared.

4. See below.

5. See below.

6. You should always attempt to set an image since sites look dull without them! All popular formats up to 1MB in size are supported. An aspect ratio of 4:3 is preferred but an attempt is made to convert the uploaded image into a 4:3 format. Applications may override this aspect ratio as they wish.

   Crop from and Effect are for advanced use. Crop from is used when the default cropping algorithm is eg. chopping a person’s head off.

7. See below.

8. See below.

9. Image overrides are for advanced use. The image you upload in 6 is converted behind the scenes into potentially many sizes. If the algorithm produces undesirable results you can override each size as required.

10. Save and publish saves the item and makes it publicly accessible.

11. Save and add another saves the item. You are redirected to a screen to add a new trivial content item.

12. Save and continue editing saves the item. You stay on the edit screen.

13. Save saves the item. You are redirected to a listing of all trivial content items.

1. Jmbo uses the Django sites framework. This means items can be selectively published to one or more sites. Select the applicable sites, or use the shortcuts to select a group of sites.
2. Publish on is an optional date on which to publish the item. If you leave it empty you must publish the item manually, eg. by clicking Save and publish.
3. Retract on is an optional date on which to retract the item. If you leave it empty you must unpublish the item manually, eg. by clicking Save and unpublish.
4. Publishers is marked for deprecation. The idea was to publish an item to eg. Facebook. Unfortunately those platforms often have unstable API’s, making it impractical.

1. Jmbo uses categories from django-category. Categorizing an item enables you to display it in a certain context. An example is a listing (as defined by jmbo-foundry) of all items in a category.
2. The primary category is considered the most important category. Once again it enables you do display the item in a certain context.
3. Freeform tagging of an item allows more ways of searching for it.
4. Created date and time is when the item was created. If you leave it empty it is automatically set to the current time.
5. The owner of the item. The dropdown may change into an autocomplete field if there are many people to choose from.

1. Enable commenting for this item. Comments will not display when disabled.
2. Enable anonymous commenting for this item.
3. Close commenting for this item. Comments will still display, but users won’t be able to add new comments.
4. Enable liking for this item. Likes will not display when disabled.
5. Enable anonymous liking for this item.
6. Close liking for this item. Likes will still display, but users won’t be able to add new likes.

A trivial item as it is seen by the public.