More docs

doc/api/index.rst

@@ -15,6 +15,7 @@ API
 
    mod_contrib_sqla
    mod_contrib_mongoengine
+   mod_contrib_mongoengine_fields
    mod_contrib_peewee
    mod_contrib_pymongo
    mod_contrib_fileadmin

doc/api/mod_contrib_mongoengine_fields.rst

+``flask.ext.admin.contrib.mongoengine.fields``
+==============================================
+
+.. automodule:: flask.ext.admin.contrib.mongoengine.fields
+
+	.. autoclass:: ModelFormField
+		:members:
+
+	.. autoclass:: MongoFileField
+		:members:
+
+	.. autoclass:: MongoImageField
+		:members:
+

doc/tips.rst

@@ -4,14 +4,25 @@ Usage Tips
 General tips
 ------------
 
-1. Use class inheritance. If your models share common functionality,
-create base class which will be responsible for this functionality.
+1. Whenever your administrative views share common functionality such as authentication,
+form validation, make use of read-only views and so on - create your own base class which
+inherits from proper Flask-Admin view class.
 
-For example - permissions. Don't implement `is_accessible` in  every administrative view. Create your own base class,
-implement is_accessible there and use it instead.
+For example, if you need to check user permissions for every call, don't implement
+`is_accessible` in  every administrative view. Create your own base class, implement
+`is_accessible` there and use this class for all your views.
 
-2. You can override templates either by using `ModelView` properties or
-putting customized version into your `templates/admin/` directory
+2. You can override used templates either by using `ModelView` properties (such as
+`list_template`, `create_template`, `edit_template`) or
+putting customized version of the template into your `templates/admin/` directory
+
+3. If you need to customize look and feel of model forms, there are two options:
+
+  - Override create/edit template
+  - Use new :mod:`flask.ext.admin.form.rules` form rendering rules
+
+4. Flask-Admin has that manage file/image uploads and store result in model field. You can
+find documentation here - :mod:`flask.ext.admin.form.upload`.
 
 
 SQLAlchemy
@@ -26,3 +37,9 @@ field. In this case, you need to manually contribute field::
             form_class = super(UserView, self).scaffold_form()
             form_class.extra = TextField('Extra')
             return form_class
+
+MongoEngine
+-----------
+
+1. Flask-Admin supports GridFS backed image and file uploads. Done through
+WTForms fields and documentation can be found here :mod:`flask.ext.admin.contrib.mongoengine.fields`.

flask_admin/contrib/mongoengine/fields.py

@@ -28,6 +28,9 @@ class ModelFormField(fields.FormField):
 
 
 class MongoFileField(fields.FileField):
+    """
+        GridFS file field.
+    """
     widget = widgets.MongoFileInput()
 
     def __init__(self, label=None, validators=None, **kwargs):
@@ -63,4 +66,8 @@ class MongoFileField(fields.FileField):
 
 
 class MongoImageField(MongoFileField):
+    """
+        GridFS image field.
+    """
+
     widget = widgets.MongoImageInput()