annotate documentation/INSTALL.txt @ 2:e5584a19768b ad

maj module ad
author sly
date Wed, 15 Apr 2009 07:58:32 +0000
parents d8a3998dac8e
children 416ea999ed76
rev   line source
pierre@0 1 -------------
pierre@0 2 Requirements:
pierre@0 3 -------------
sly@2 4 - Drupal 6.x
sly@2 5 - taxonomy.module
pierre@0 6 - upload.module (if using the ad_image module)
pierre@0 7
pierre@0 8 -------------
pierre@0 9 Installation:
pierre@0 10 -------------
pierre@0 11 1) Extract the ad tarball. Move the resulting 'ad/' subdirectory within your
pierre@0 12 'modules/' directory. Be sure the web server has read permissions to this
pierre@0 13 directory and the files within it.
pierre@0 14
pierre@0 15 NOTE: For optimal performance you should set the DRUPAL_ROOT variable at
pierre@0 16 the top of the adserve.inc file. Otherwise, the ad module will automatically
pierre@0 17 determine your top level Drupal directory each time it serves an
pierre@0 18 advertisement.
pierre@0 19
pierre@0 20 2) Log in to your website and enable the ad.module.
pierre@0 21 (Goto :: administer >> modules :: then put a check next to 'ad')
pierre@0 22
pierre@0 23 3) If you wish to display image (banner) ads, enable the ad_image.module. If
pierre@0 24 it's not already enabled, you will also need to enable the upload.module.
pierre@0 25 (Goto :: administer >> modules :: then put a check next to 'ad_image' and
pierre@0 26 'upload'.)
pierre@0 27
pierre@0 28 You can set per-group limitations for image ads at administer >> modules >>
pierre@0 29 groups >> image ads.
pierre@0 30
pierre@0 31 4) If you wish to display text ads, enable the ad_text.module.
pierre@0 32 (Goto :: administer >> modules :: then put a check next to 'ad_text')
pierre@0 33
pierre@0 34 You can set global limitations for text ads at administer >> modules >>
pierre@0 35 settings >> text ads.
pierre@0 36
pierre@0 37 5) If you wish to embed ads into your site content, enable the ad_embed.module.
pierre@0 38 (Goto :: administer >> modules :: then put a check next to 'ad_embed')
pierre@0 39
pierre@0 40 You can configure embedded ads at administer >> modules >> settings >>
pierre@0 41 embedded ads. There is also online help available if you enable the Drupal
pierre@0 42 help module and go to administer >> help >> ad_embed.
pierre@0 43
pierre@0 44 6) If you wish to provide online graphical reports along with your ads, enable
pierre@0 45 the ad_report module.
pierre@0 46 (Goto :: administer >> modules :: then put a check next to 'ad_report')
pierre@0 47
pierre@0 48 7) Assign the 'show advertisements' permission to all roles that you wish to
pierre@0 49 see advertisements.
pierre@0 50 (Goto :: administer >> user management >> access control :: then put a
pierre@0 51 check next to 'show advertisements' for all roles that should see ads)
pierre@0 52
pierre@0 53 8) You can display ads in blocks by going to administer >> blocks and enabling
pierre@0 54 the per-ad-group blocks that are automatically generated.
pierre@0 55
pierre@0 56 9) Optionally configure an input filter for your advertisements that allow
pierre@0 57 the html tags to display correctly.
pierre@0 58 (Goto :: administer >> site configuration >> input filters)
pierre@0 59 If you need to associate a specific input filter with the advertisement
pierre@0 60 content type, you may want to review the following projects:
pierre@0 61 http://drupal.org/project/better_formats
pierre@0 62 http://drupal.org/project/filterbynodetype