You are here

Home » API reference » Content Injector (formerly AdSense Injector) 6.2

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

Same filename and directory in other branches
  1. 5.2 README.txt
  2. 5 README.txt
  3. 6.3 README.txt
  4. 6 README.txt
  5. 7.3 README.txt
  6. 7 README.txt
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. 

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

  3. 

  4. 

  5. ABOUT ADSENSE INJECTOR

  6. ----------------------

  7. 

  8. The purpose of this module is to provide a simple method of automatically

  9. placing 'inline' adsense module content into a full-page view of selected

  10. node types. It does this by intercepting node rendering using hook_nodeapi

  11. during 'page' rendering, and injecting selected text into the $node->body

  12. field.

  13. 

  14. It uses a very simple scheme at present (just string concatenation) and

  15. could be enhanced greatly by using regular expressions, templates, or other

  16. techniques in a later revision.

  17. 

  18. Official Adsense Injector project page:

  19.   http://exodusdev.com/drupal/4.7/modules/adsense_injector.module

  20. 

  21. Drupal Adsense Injector project page:

  22.   http://drupal.org/project/adsense_injector

  23. 

  24. Sponsored by:

  25.   http://exodusdev.com/

  26. 

  27. 

  28. RATIONALE

  29. ----------------------

  30. 

  31. Why is this useful? In my experience, this simplifies certain important

  32. aspects of ad insertion and placement.

  33. 

  34. Traditional approaches:

  35. 

  36.   - Modify your theme's node.tpl.php or other template file(s) in order to

  37.     inject ads on every node view.

  38. 

  39.     What happens if you have multiple sites or use multiple themes, or use

  40.     custom per-node-type template files (node-book.tpl.php, node-image.tpl.php

  41.     etc)? Now you have to edit, test, and maintain multiple template files,

  42.     and, if the theme is updated to fix bugs, you have to merge in your

  43.     changes.

  44. 

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

  46.     tags.

  47. 

  48.     This gives tremendous flexibility in layout, but creates a maintenance

  49.     nightmare if you should wish to alter your channel or ad layouts site-wide.

  50. 

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

  52. 

  53.     This is great if your theme's regions provide the flexibility you want - it

  54.     seems that themes vary somewhat in the regions they provide, and those

  55.     regions aren't always in the places you want - so once again, you are back

  56.     to tweaking theme template files if you want to place the ads near or in

  57.     the content.

  58. 

  59. 

  60. USAGE

  61. ----------------------

  62. 

  63. AdSense Injector uses (and requires) installation and proper configuration of

  64. the AdSense Module in order to function properly. Please install, configure,

  65. and test the AdSense module before you install Adsense Injector.

  66. 

  67. 

  68. ANY DETAIL VISIBILITY CONTROL?

  69. ----------------------

  70. 

  71. You may looking for some detail visibility control as like as that of block

  72. visibility, e.g. with PHP-mode which target for expert only.

  73. 

  74. This will not exists for adsense injector module, as adsense module already

  75. coming with similar visibility control managment. For keeping this module as

  76. simple as possibility, we will not duplicate this handling.

  77. 

  78. For more detail:

  79.   http://drupal.org/node/136031

  80.   http://drupal.org/node/198907

  81. 

  82. 

  83. LIST OF MAINTAINERS

  84. ----------------------

  85. 

  86. PROJECT OWNER

  87. M: Michael Curry 

  88. S: maintained

  89. W: http://exodusdev.com/

  90. 

  91. CO-MAINTAINER

  92. M: Edison Wong 

  93. S: maintained

  94. W: http://edin.no-ip.com/