You are here

README.txt in Image Assist 6

-- SUMMARY --

Image Assist provides a user interface for adding images to any textarea that is
aware of input formats.

For a full description visit the project page:
  http://drupal.org/project/img_assist
Bug reports, feature suggestions and latest developments:
  http://drupal.org/project/issues/img_assist


-- INSTALLATION --

* See INSTALL.txt in this directory.


-- USAGE --

Read this after installing the module.

* Using this module with TinyMCE:
  1. Click the camera icon on the TinyMCE toolbar.
  2. Upload a new photo or choose an existing image.
  3. Set the properties for how you want the image to display.
  4. Click the Insert button.

* Using this module with any textarea:
  1. Click the "Add image" link or camera icon under any textarea box. 
  2. Upload a new photo or choose an existing image.
  3. Set the properties for how you want the image to display.
  4. Click the Insert button.

* Most browsers, such as Internet Explorer and Mozilla clones, will insert the
  image exactly where you place your cursor in the textarea of your content
  form. Otherwise the image will be appended to the end of your entry.

* Adding images with Image module

  Users with the 'access img_assist' permission will see the 'add image' link
  or icon (configurable). Access to img_assist via the TinyMCE plugin is
  controlled by the TinyMCE module.  

  Users with the 'create images' permission will be able to upload images using
  img_assist. All users will be able to see and insert their own pictures, even
  if the image nodes are unpublished. Users with the 'access all images'
  permission will also be able to use other images, but only if they are
  published.

  One possible workflow would be to set images to be UNPUBLISHED by default.
  That way users can upload, categorize, and use images in img_assist without
  the images showing up anyway else on the site. Images that should  also be
  shown elsewhere on the site can manually be published by going to
  administer > content.

* Image presentation

  A full img_assist tag looks like this:

  [img_assist|nid=2|title=My title|desc=My description|align=right|width=200|height=150|link=url,http://www.google.com]


-- TROUBLESHOOTING --

* If your site is accessible from multiple domains, embedded image tags and
  links in contents will point to the domain/URL that was accessed upon first
  view of a content.  In most cases, you want to re-generate this cached content
  after staging from a development server to a live server.  For this purpose,
  go to Image Assist's settings page and click on the link (pointing to
  'img_assist/cache/clear') in the help text at the beginning of the page.

  To circumvent this permanently, as with any other module, you need to setup
  separate database tables for Drupal's cache.  Image Assist primarily works in
  the cache_filter table.  See sites/default/settings.php for more information.

* In front of submitting a new bug report, support or feature request, please
  search the issue queue for already existing issues.

  Note: FAILURE TO DO SO WILL EXTEND THE TIME FOR ISSUES TO BE SOLVED.

* If you are successfully using this module, please consider helping out on
  support requests in the issue queue.

* If you have a development site in progress, please test patches needing review.
  See http://drupal.org/patch/apply for further information.


-- FAQ --

Q: After installing Image Assist plugin for TinyMCE, the plugin does not show up
   in TinyMCE's list of "Buttons and Plugins"?

A: Unfortunately, TinyMCE module comes with two folders named 'plugins'. Please
   ensure that you have copied Image Assist's drupalimage plugin into the folder
   [sites/all]/modules/tinymce/tinymce/jscripts/tiny_mce/plugins/


-- CONTACT --

Current maintainers:
* Daniel F. Kudwien (sun) <http://www.unleashedmind.com>
* Hannes Lilljequist (zoo33) <http://www.perrito.se>
* Darren Oh (darrenoh) <http://darrenoh.dnsalias.com>

Previous maintainers:
* Benjamin Shell (benshell) <http://www.benjaminshell.com>
* Matt Westgate (matt westgate) <http://drupal.org/user/2275>

This project has been sponsored by:
* UNLEASHED MIND
  Specialized in consulting and planning of Drupal powered sites, UNLEASHED
  MIND offers installation, development, theming, customization, and hosting
  to get you started. Visit http://www.unleashedmind.com for more information.

File

README.txt
View source
  1. -- SUMMARY --
  2. Image Assist provides a user interface for adding images to any textarea that is
  3. aware of input formats.
  4. For a full description visit the project page:
  5. http://drupal.org/project/img_assist
  6. Bug reports, feature suggestions and latest developments:
  7. http://drupal.org/project/issues/img_assist
  8. -- INSTALLATION --
  9. * See INSTALL.txt in this directory.
  10. -- USAGE --
  11. Read this after installing the module.
  12. * Using this module with TinyMCE:
  13. 1. Click the camera icon on the TinyMCE toolbar.
  14. 2. Upload a new photo or choose an existing image.
  15. 3. Set the properties for how you want the image to display.
  16. 4. Click the Insert button.
  17. * Using this module with any textarea:
  18. 1. Click the "Add image" link or camera icon under any textarea box.
  19. 2. Upload a new photo or choose an existing image.
  20. 3. Set the properties for how you want the image to display.
  21. 4. Click the Insert button.
  22. * Most browsers, such as Internet Explorer and Mozilla clones, will insert the
  23. image exactly where you place your cursor in the textarea of your content
  24. form. Otherwise the image will be appended to the end of your entry.
  25. * Adding images with Image module
  26. Users with the 'access img_assist' permission will see the 'add image' link
  27. or icon (configurable). Access to img_assist via the TinyMCE plugin is
  28. controlled by the TinyMCE module.
  29. Users with the 'create images' permission will be able to upload images using
  30. img_assist. All users will be able to see and insert their own pictures, even
  31. if the image nodes are unpublished. Users with the 'access all images'
  32. permission will also be able to use other images, but only if they are
  33. published.
  34. One possible workflow would be to set images to be UNPUBLISHED by default.
  35. That way users can upload, categorize, and use images in img_assist without
  36. the images showing up anyway else on the site. Images that should also be
  37. shown elsewhere on the site can manually be published by going to
  38. administer > content.
  39. * Image presentation
  40. A full img_assist tag looks like this:
  41. [img_assist|nid=2|title=My title|desc=My description|align=right|width=200|height=150|link=url,http://www.google.com]
  42. -- TROUBLESHOOTING --
  43. * If your site is accessible from multiple domains, embedded image tags and
  44. links in contents will point to the domain/URL that was accessed upon first
  45. view of a content. In most cases, you want to re-generate this cached content
  46. after staging from a development server to a live server. For this purpose,
  47. go to Image Assist's settings page and click on the link (pointing to
  48. 'img_assist/cache/clear') in the help text at the beginning of the page.
  49. To circumvent this permanently, as with any other module, you need to setup
  50. separate database tables for Drupal's cache. Image Assist primarily works in
  51. the cache_filter table. See sites/default/settings.php for more information.
  52. * In front of submitting a new bug report, support or feature request, please
  53. search the issue queue for already existing issues.
  54. Note: FAILURE TO DO SO WILL EXTEND THE TIME FOR ISSUES TO BE SOLVED.
  55. * If you are successfully using this module, please consider helping out on
  56. support requests in the issue queue.
  57. * If you have a development site in progress, please test patches needing review.
  58. See http://drupal.org/patch/apply for further information.
  59. -- FAQ --
  60. Q: After installing Image Assist plugin for TinyMCE, the plugin does not show up
  61. in TinyMCE's list of "Buttons and Plugins"?
  62. A: Unfortunately, TinyMCE module comes with two folders named 'plugins'. Please
  63. ensure that you have copied Image Assist's drupalimage plugin into the folder
  64. [sites/all]/modules/tinymce/tinymce/jscripts/tiny_mce/plugins/
  65. -- CONTACT --
  66. Current maintainers:
  67. * Daniel F. Kudwien (sun)
  68. * Hannes Lilljequist (zoo33)
  69. * Darren Oh (darrenoh)
  70. Previous maintainers:
  71. * Benjamin Shell (benshell)
  72. * Matt Westgate (matt westgate)
  73. This project has been sponsored by:
  74. * UNLEASHED MIND
  75. Specialized in consulting and planning of Drupal powered sites, UNLEASHED
  76. MIND offers installation, development, theming, customization, and hosting
  77. to get you started. Visit http://www.unleashedmind.com for more information.