You are here

README.txt in Insert 6

Same filename and directory in other branches
  1. 7 README.txt
Insert is a utility that makes inserting images and links to files into text
areas or WYSIWYGs much easier. It adds a simple JavaScript-based button to
FileField and ImageField widgets. When used with ImageField and ImageCache,
images may be inserted into text areas with a specific ImageCache preset.

Insert was written by Nate Haug.

This Module Made by Robots: http://www.lullabot.com

Dependencies
------------

Insert module does not have any dependencies, but it won't do anything unless
you have at least one of the following installed:

* FileField
* ImageField

Recommended
-----------

* ImageCache
* WYSIWYG module

Install
-------

1) Copy the insert folder to the modules folder in your installation. Usually
   this is sites/all/modules.

2) In your Drupal site, enable the module under Administer -> Site building ->
   Modules (/admin/build/modules).

3) Add or configure a FileField or ImageField under Administer -> Content
   management -> Content types -> [type] -> Manage Fields
   (admin/content/node-type/[type]/fields). Once configuring a field, there is a
   new section in the Field options for "Insert". You can then configure the
   field to include an Insert button and what templates you would like to have.

4) Create a piece of content with the configured field. After uploading a file,
   an "Insert" button will appear. Click this button to send the file or image
   into the Body field.

Insert should work on multiple fields (the last field that was active will
receive the file), and with most popular WYSIWYG editors.

Theming
-------

Insert can be configured to work with non-HTML filters like BBCode or Markdown.
To do this, copy the template file you would like to change from the "templates"
directory to your active theme's directory. Then empty your Drupal caches at
admin/settings/performance.

The ImageCache templates may also be used per ImageCache preset. You can copy
the imagecache-insert-image.tpl.php file to your theme directory and then
rename it to imagecache-insert-image--[preset-name].tpl.php, where [preset-name]
is the name of the ImageCache preset. Change underscores to hyphens in the
preset name.

File

README.txt
View source
  1. Insert is a utility that makes inserting images and links to files into text
  2. areas or WYSIWYGs much easier. It adds a simple JavaScript-based button to
  3. FileField and ImageField widgets. When used with ImageField and ImageCache,
  4. images may be inserted into text areas with a specific ImageCache preset.
  5. Insert was written by Nate Haug.
  6. This Module Made by Robots: http://www.lullabot.com
  7. Dependencies
  8. ------------
  9. Insert module does not have any dependencies, but it won't do anything unless
  10. you have at least one of the following installed:
  11. * FileField
  12. * ImageField
  13. Recommended
  14. -----------
  15. * ImageCache
  16. * WYSIWYG module
  17. Install
  18. -------
  19. 1) Copy the insert folder to the modules folder in your installation. Usually
  20. this is sites/all/modules.
  21. 2) In your Drupal site, enable the module under Administer -> Site building ->
  22. Modules (/admin/build/modules).
  23. 3) Add or configure a FileField or ImageField under Administer -> Content
  24. management -> Content types -> [type] -> Manage Fields
  25. (admin/content/node-type/[type]/fields). Once configuring a field, there is a
  26. new section in the Field options for "Insert". You can then configure the
  27. field to include an Insert button and what templates you would like to have.
  28. 4) Create a piece of content with the configured field. After uploading a file,
  29. an "Insert" button will appear. Click this button to send the file or image
  30. into the Body field.
  31. Insert should work on multiple fields (the last field that was active will
  32. receive the file), and with most popular WYSIWYG editors.
  33. Theming
  34. -------
  35. Insert can be configured to work with non-HTML filters like BBCode or Markdown.
  36. To do this, copy the template file you would like to change from the "templates"
  37. directory to your active theme's directory. Then empty your Drupal caches at
  38. admin/settings/performance.
  39. The ImageCache templates may also be used per ImageCache preset. You can copy
  40. the imagecache-insert-image.tpl.php file to your theme directory and then
  41. rename it to imagecache-insert-image--[preset-name].tpl.php, where [preset-name]
  42. is the name of the ImageCache preset. Change underscores to hyphens in the
  43. preset name.