You are here

INSTALL.txt in Image Assist 6

Same filename and directory in other branches
  1. 5 INSTALL.txt
-- REQUIREMENTS --

* Javascript-enabled web browser

* Image module <http://drupal.org/project/image>

* TinyMCE module (optional) <http://drupal.org/project/tinymce>


-- PRE-REQUISITES --

* If you are upgrading from a previous version, please

  - follow the compatibility note on http://drupal.org/project/img_assist

  - backup your files and database in front of the upgrade

  - run Drupal's update.php after updating the module's files.
    Further information: http://drupal.org/upgrade/running-update-php

  - read notes about important changes that may affect your site or theme in
    CHANGELOG.txt.

  - update your theme, especially if you have any theme override functions for
    image or img_assist.


-- INSTALLATION --

* Place the entire img_assist directory into a modules directory of your
  choice, in most cases: sites/all/modules.

* Enable the Image Assist module by navigating to:

  Administer > Site building > Modules

* Configure an input format and enable the filter 'Inline images' by visiting:

  Administer > Site configuration > Input formats

  If you want to enable Inline images for the input format 'Filtered HTML',
  you additionally need to click the 'Configure' tab and add

  <span> <img>

  to the text field 'Allowed HTML tags'.

* Set permissions for using Image Assist by going to:

  Administer > User management > Access control

* Optionally fine tune how Image Assist operates by navigating to:

  Administer > Site configuration > Image assist

  If Taxonomy module is enabled, you use a gallery module like Acidfree, and you
  want your users to be able to easily choose images from their galleries, select
  for example "Acidfree albums" as the vocabulary to use for Image assist.


-- TINYMCE PLUGIN INSTALLATION --

If you use the TinyMCE WYSIWYG editor, you need to install a plugin for Image
Assist.

* Move or copy the folder 'drupalimage' in the img_assist directory to

  [sites/all/]modules/tinymce/tinymce/jscripts/tiny_mce/plugins/
   
  Edit the file plugin_reg.php in the tinymce directory. It's located in:

  [sites/all/]modules/tinymce/plugin_reg.php

  Add the following lines anywhere above the 'return' statement (without the
  <code> tags):
<code>
  $plugins['drupalimage'] = array();
  $plugins['drupalimage']['theme_advanced_buttons1'] = array('drupalimage');
  $plugins['drupalimage']['extended_valid_elements'] = array('img[class|src|border=0|alt|title|width|height|align|name|style]');
</code>

  Next, go to

  Administer > Site configuration > TinyMCE

  and enable the drupalimage plugin in your TinyMCE profile.


File

INSTALL.txt
View source
  1. -- REQUIREMENTS --
  2. * Javascript-enabled web browser
  3. * Image module
  4. * TinyMCE module (optional)
  5. -- PRE-REQUISITES --
  6. * If you are upgrading from a previous version, please
  7. - follow the compatibility note on http://drupal.org/project/img_assist
  8. - backup your files and database in front of the upgrade
  9. - run Drupal's update.php after updating the module's files.
  10. Further information: http://drupal.org/upgrade/running-update-php
  11. - read notes about important changes that may affect your site or theme in
  12. CHANGELOG.txt.
  13. - update your theme, especially if you have any theme override functions for
  14. image or img_assist.
  15. -- INSTALLATION --
  16. * Place the entire img_assist directory into a modules directory of your
  17. choice, in most cases: sites/all/modules.
  18. * Enable the Image Assist module by navigating to:
  19. Administer > Site building > Modules
  20. * Configure an input format and enable the filter 'Inline images' by visiting:
  21. Administer > Site configuration > Input formats
  22. If you want to enable Inline images for the input format 'Filtered HTML',
  23. you additionally need to click the 'Configure' tab and add
  24. to the text field 'Allowed HTML tags'.
  25. * Set permissions for using Image Assist by going to:
  26. Administer > User management > Access control
  27. * Optionally fine tune how Image Assist operates by navigating to:
  28. Administer > Site configuration > Image assist
  29. If Taxonomy module is enabled, you use a gallery module like Acidfree, and you
  30. want your users to be able to easily choose images from their galleries, select
  31. for example "Acidfree albums" as the vocabulary to use for Image assist.
  32. -- TINYMCE PLUGIN INSTALLATION --
  33. If you use the TinyMCE WYSIWYG editor, you need to install a plugin for Image
  34. Assist.
  35. * Move or copy the folder 'drupalimage' in the img_assist directory to
  36. [sites/all/]modules/tinymce/tinymce/jscripts/tiny_mce/plugins/
  37. Edit the file plugin_reg.php in the tinymce directory. It's located in:
  38. [sites/all/]modules/tinymce/plugin_reg.php
  39. Add the following lines anywhere above the 'return' statement (without the
  40. tags):
  41. $plugins['drupalimage'] = array();
  42. $plugins['drupalimage']['theme_advanced_buttons1'] = array('drupalimage');
  43. $plugins['drupalimage']['extended_valid_elements'] = array('img[class|src|border=0|alt|title|width|height|align|name|style]');
  44. Next, go to
  45. Administer > Site configuration > TinyMCE
  46. and enable the drupalimage plugin in your TinyMCE profile.