1# Google AdSense for DokuWiki
2
3## License
4
5* **Author**: [Terence J. Grant](mailto:tjgrant@tatewake.com) (with special thanks to [Bernd Zeimetz](bernd@bzed.de))
6* **License**: [GNU GPL v2](http://opensource.org/licenses/GPL-2.0)
7* **Latest Release**: v1.0.1 on Sep 15th, 2020
8* **Changes**: See [CHANGELOG.md](CHANGELOG.md) for full details.
9* **Donate**: [Donations](http://tjgrant.com/wiki/donate) and [Sponsorships](https://github.com/sponsors/tatewake) are appreciated!
10
11## About
12
13This tool allows you to set a code for use with [Google AdSense](https://en.wikipedia.org/wiki/Google_AdSense), which allows you to put targeted advertisements on your site.
14
15The plugin also exports a function for use with your template, so you will have to insert the following code into your template's **main.php**, somewhere inside of the `<head></head>` tags.
16
17	<?php
18	if (file_exists(DOKU_PLUGIN.'googleads/code.php')) include_once(DOKU_PLUGIN.'googleads/code.php');
19	if (function_exists('gads_code')) gads_code();
20	?>
21
22**Note**: Inserting the code above is **required**, not optional.
23
24**Template Authors Note**: You can insert the above code and make your template "Google AdSense Ready", even if your users do not use Google AdSense (or have this plugin.)
25
26## Install / Upgrade
27
28Search and install the plugin using the [Extension Manager](https://www.dokuwiki.org/plugin:extension). Refer to [Plugins](https://www.dokuwiki.org/plugins) on how to install plugins manually.
29
30## Setup
31
32All further documentation for this plugin can be found at:
33
34 * [https://www.dokuwiki.org/plugin:googleads](https://www.dokuwiki.org/plugin:googleads)
35
36## Contributing
37
38The official repository for this plugin is available on GitHub:
39
40* [https://github.com/tatewake/dokuwiki-plugin-googleads](https://github.com/tatewake/dokuwiki-plugin-googleads)
41
42The plugin thrives from community contributions. If you're able to provide useful code changes or bug fixes, they will likely be accepted to future versions of the plugin.
43
44If you find my work helpful and would like to give back, [consider joining me as a GitHub sponsor](https://github.com/sponsors/tatewake).
45
46Thanks!
47
48--Terence
49