Autarchy of the Private Cave

If you ever need to add AdSense units to your Gallery2 installation, and find no module for this - try following the text below. I compiled it from several sources (primary menalto.com Gallery2 forum), and did everything written here myself here.

Primary source of information was this post, but I recommend that you follow instructions here.

To add AdSense to your Gallery2 sidebar (when using the Matrix theme as a sample):

1. copy themes/matrix/templates/sidebar.tpl to theme/matrix/templates/local/sidebar.tpl on your server. This is needed to preserve your modifications when the Matrix theme will be upgraded.
2. any further modifications should be done in your newly copied local/sidebar.tpl file.
3. create the file which will contain all your AdSense code - e.g., let it be adsense_160x600.tpl for the Wide Scyscraper format. Put all your AdSense code into that file, and upload the file to your theme/matrix/templates/local/ folder on the server.
4. now edit the sidebar.tpl file. My original file looked like this:
   PLAIN TEXT
   SMARTY:

   1. <div id="gsSidebar" class="gcBorder1">
   2.   {* Show the sidebar blocks chosen for this theme *}
   3.   {foreach from=$theme.params.sidebarBlocks item=block}
   4.     {g->block type=$block.0 params=$block.1 class="gbBlock"}
   5.   {/foreach}
   6.   {g->block type="core.NavigationLinks" class="gbBlock"}
   7. </div>

   I added

   PLAIN TEXT
   SMARTY:

   1. {if $user.isGuest == 1}
   2. {* adsense code *}
   3. {g->theme include="adsense_160x600.tpl" class="gbBlock"}
   4. {/if}

   and final file looked like this:

   PLAIN TEXT
   SMARTY:

   1. {*
   2. * $Revision: 1.2 $
   3. * If you want to customize this file, do not edit it directly since future upgrades
   4. * may overwrite it.  Instead, copy it into a new directory called "local" and edit that
   5. * version.  Gallery will look for that file first and use it if it exists.
   6. *}
   7. <div id="gsSidebar" class="gcBorder1">
   8.   {* Show the sidebar blocks chosen for this theme *}
   9.   {foreach from=$theme.params.sidebarBlocks item=block}
   10.     {g->block type=$block.0 params=$block.1 class="gbBlock"}
   11.   {/foreach}
   12.   {g->block type="core.NavigationLinks" class="gbBlock"}
   13. {if $user.isGuest == 1}
   14. {* adsense code *}
   15. {g->theme include="adsense_160x600.tpl" class="gbBlock"}
   16. {/if}
   17. </div>

5. well, basically you are done. If you need/want to, you can wrap the inserted code into some styled container, to define the look of the block, like:
   PLAIN TEXT
   SMARTY:

   1. <div id="adBar" class="gcBorder1">{if $user.isGuest == 1}
   2. {* adsense code *}
   3. {g->theme include="adsense_160x600.tpl" class="gbBlock"}
   4. {/if}</div>

6. you can use any AdSense format you like, but you must mind the width of the sidebar in your theme - so that site layout is not broken by too wide AdSense units.

Finally, some more hints and explanations.

The smarty variables for users in Gallery2 are:

• $user.isGuest
• $user.isRegisteredUser
• $user.isAdmin

As you might have noticed, in the code above AdSense unit is shown ONLY IF the page visitor is a Guest. Thus ads will not be shown to Registered Users and Admin. I did not manage to find this condition in Google's AdSense Policy, but the source post author states that showing Google Ads in password-protected areas is a violation of Google's Terms Of Service (TOS). Again - I did not find that, but in good faith I provide the code which limits ads to guest-only users. If you want to show ads to any user class - just remove the first {if} and last {/if} lines from the code. Any knowledgeable comments on this (preferrably with URLs) are very welcome, as personally I see nothing bad in putting AdSense onto password-protected pages in the case of the Gallery, where photos are the main type of content.

To add multiple ad units - create a single file for each distinct ad format/type you want to use, and include it using the code shown above. Just keep in mind limitations imposed by Google on the number of ad units of different types on a single page.

Hope this helps, and good luck to you.