You are here

README.txt in Content Injector (formerly AdSense Injector) 7

Copyright 2006-2008 Exodus Development, Inc. (http://exodusdev.com)


ABOUT ADSENSE INJECTOR
----------------------

The purpose of this module is to provide a simple method of automatically
placing 'inline' adsense module content into a full-page view of selected
node types. It does this by intercepting node rendering using hook_nodeapi
during 'page' rendering, and injecting selected text into the $node->body
field.

It uses a very simple scheme at present (just string concatenation) and
could be enhanced greatly by using regular expressions, templates, or other
techniques in a later revision.

Official Adsense Injector project page:
  http://exodusdev.com/drupal/4.7/modules/adsense_injector.module

Drupal Adsense Injector project page:
  http://drupal.org/project/adsense_injector

Sponsored by:
  http://exodusdev.com/


RATIONALE
----------------------

Why is this useful? In my experience, this simplifies certain important
aspects of ad insertion and placement.

Traditional approaches:

  - Modify your theme's node.tpl.php or other template file(s) in order to
    inject ads on every node view.

    What happens if you have multiple sites or use multiple themes, or use
    custom per-node-type template files (node-book.tpl.php, node-image.tpl.php
    etc)? Now you have to edit, test, and maintain multiple template files,
    and, if the theme is updated to fix bugs, you have to merge in your
    changes.

  - Hand-edit each node content and use inline [adsense:x:y] inline filter
    tags.

    This gives tremendous flexibility in layout, but creates a maintenance
    nightmare if you should wish to alter your channel or ad layouts site-wide.

  - Use block insertion into the theme's template regions.

    This is great if your theme's regions provide the flexibility you want - it
    seems that themes vary somewhat in the regions they provide, and those
    regions aren't always in the places you want - so once again, you are back
    to tweaking theme template files if you want to place the ads near or in
    the content.


USAGE
----------------------

AdSense Injector uses (and requires) installation and proper configuration of
the AdSense Module in order to function properly. Please install, configure,
and test the AdSense module before you install Adsense Injector.


ANY DETAIL VISIBILITY CONTROL?
----------------------

You may looking for some detail visibility control as like as that of block
visibility, e.g. with PHP-mode which target for expert only.

This will not exists for adsense injector module, as adsense module already
coming with similar visibility control managment. For keeping this module as
simple as possibility, we will not duplicate this handling.

For more detail:
  http://drupal.org/node/136031
  http://drupal.org/node/198907


LIST OF MAINTAINERS
----------------------

PROJECT OWNER
M: Michael Curry <exodusdev@gmail.com>
S: maintained
W: http://exodusdev.com/

CO-MAINTAINER
M: Edison Wong <hswong3i@gmail.com>
S: maintained
W: http://edin.no-ip.com/

File

README.txt
View source
  1. Copyright 2006-2008 Exodus Development, Inc. (http://exodusdev.com)
  2. ABOUT ADSENSE INJECTOR
  3. ----------------------
  4. The purpose of this module is to provide a simple method of automatically
  5. placing 'inline' adsense module content into a full-page view of selected
  6. node types. It does this by intercepting node rendering using hook_nodeapi
  7. during 'page' rendering, and injecting selected text into the $node->body
  8. field.
  9. It uses a very simple scheme at present (just string concatenation) and
  10. could be enhanced greatly by using regular expressions, templates, or other
  11. techniques in a later revision.
  12. Official Adsense Injector project page:
  13. http://exodusdev.com/drupal/4.7/modules/adsense_injector.module
  14. Drupal Adsense Injector project page:
  15. http://drupal.org/project/adsense_injector
  16. Sponsored by:
  17. http://exodusdev.com/
  18. RATIONALE
  19. ----------------------
  20. Why is this useful? In my experience, this simplifies certain important
  21. aspects of ad insertion and placement.
  22. Traditional approaches:
  23. - Modify your theme's node.tpl.php or other template file(s) in order to
  24. inject ads on every node view.
  25. What happens if you have multiple sites or use multiple themes, or use
  26. custom per-node-type template files (node-book.tpl.php, node-image.tpl.php
  27. etc)? Now you have to edit, test, and maintain multiple template files,
  28. and, if the theme is updated to fix bugs, you have to merge in your
  29. changes.
  30. - Hand-edit each node content and use inline [adsense:x:y] inline filter
  31. tags.
  32. This gives tremendous flexibility in layout, but creates a maintenance
  33. nightmare if you should wish to alter your channel or ad layouts site-wide.
  34. - Use block insertion into the theme's template regions.
  35. This is great if your theme's regions provide the flexibility you want - it
  36. seems that themes vary somewhat in the regions they provide, and those
  37. regions aren't always in the places you want - so once again, you are back
  38. to tweaking theme template files if you want to place the ads near or in
  39. the content.
  40. USAGE
  41. ----------------------
  42. AdSense Injector uses (and requires) installation and proper configuration of
  43. the AdSense Module in order to function properly. Please install, configure,
  44. and test the AdSense module before you install Adsense Injector.
  45. ANY DETAIL VISIBILITY CONTROL?
  46. ----------------------
  47. You may looking for some detail visibility control as like as that of block
  48. visibility, e.g. with PHP-mode which target for expert only.
  49. This will not exists for adsense injector module, as adsense module already
  50. coming with similar visibility control managment. For keeping this module as
  51. simple as possibility, we will not duplicate this handling.
  52. For more detail:
  53. http://drupal.org/node/136031
  54. http://drupal.org/node/198907
  55. LIST OF MAINTAINERS
  56. ----------------------
  57. PROJECT OWNER
  58. M: Michael Curry
  59. S: maintained
  60. W: http://exodusdev.com/
  61. CO-MAINTAINER
  62. M: Edison Wong
  63. S: maintained
  64. W: http://edin.no-ip.com/