Mercurial > defr > drupal > ad
comparison documentation/README.txt @ 7:6aeff3329e01 ad
maj module ad 2.1rc1
| author | piotre |
|---|---|
| date | Mon, 20 Jul 2009 13:54:40 +0000 |
| parents | 416ea999ed76 |
| children | 32c1a7d9e1fa |
comparison
equal
deleted
inserted
replaced
| 6:b7653861e0b4 | 7:6aeff3329e01 |
|---|---|
| 50 ------------- | 50 ------------- |
| 51 Once the ad module is properly installed an enabled, you can create | 51 Once the ad module is properly installed an enabled, you can create |
| 52 advertisements by visiting 'create content' on your website and choosing | 52 advertisements by visiting 'create content' on your website and choosing |
| 53 'advertisement' as the content type. If you have enabled multiple ad type | 53 'advertisement' as the content type. If you have enabled multiple ad type |
| 54 modules, you can select one of them from the resulting menu, such as 'image | 54 modules, you can select one of them from the resulting menu, such as 'image |
| 55 advertiesment' or 'text advertisement'. | 55 advertisement' or 'text advertisement'. |
| 56 | 56 |
| 57 Text ads: | 57 Text ads: |
| 58 --------- | 58 --------- |
| 59 Text ads are very simple, requiring that you fill out only three fields of | 59 Text ads are very simple, requiring that you fill out only three fields of |
| 60 information. First, you need to specify the Destination URL where you want | 60 information. First, you need to specify the Destination URL where you want |
| 259 | 259 |
| 260 Even if you do not plan to make any changes, you should visit this page at | 260 Even if you do not plan to make any changes, you should visit this page at |
| 261 least one time as the ad module will perform a series of sanity tests when | 261 least one time as the ad module will perform a series of sanity tests when |
| 262 you visit this page, alerting you to any installation problems. | 262 you visit this page, alerting you to any installation problems. |
| 263 | 263 |
| 264 This page begins by displaying the path to serve.php. If you see an error | 264 This page is divided into sections. The "Status" section validates that the |
| 265 here, then the ad module is not properly installed. Review the directions | 265 module can find the necessary scripts for serving advertisements. If |
| 266 in INSTALL.txt to properly install the ad module. | 266 everything is properly installed, it will show you the automatically detected |
| 267 | 267 paths to serve.ph and adserve.inc. If you instead see errors in this section, |
| 268 In the General section you can specify what happens when an advertisement is | 268 review the directions in INSTALL.txt to get the ad module properly installed. |
| 269 clicked. For example, you can choose to have the resulting Destination URL | 269 |
| 270 opened in the same browser window, or in a new browser window. You can also | 270 In the "General" section you can configure what happens when an advertisement |
| 271 enable the "nofollow" check box causing ads served by the ad module to | 271 is clicked by setting the 'Click-through target'. You can also enable the |
| 272 include rel="nofollow" in automatically generated links. You can select | 272 'nofollow' option to add 'rel="nofollow"' to all links generated by the ad |
| 273 to display advertisements using JavaScript, jQuery, IFrames, or Raw HTML. | 273 module. The 'Display type' allows you to alter how advertisements are |
| 274 Finally, you can disable URL validation, and enable advertisement filtering. | 274 displayed, using JavaScript, jQuery, IFrames, or simply embedding raw HTML |
| 275 | 275 into your page. Regardless of the 'Display type' the ad module will |
| 276 Checking 'Filter ads' allows you to apply Drupal's standard input filters | 276 accurately track how many times each advertisement is displayed and clicked. |
| 277 to your advertisements. If you enable this option, be sure to apply a | 277 Finally, the 'Validate URLs' option tells the module whether or not it |
| 278 compatible filter that doesn't strip away the <div> and other tags used by | 278 should use Drupal's built in URL validation logic to ensure that the |
| 279 the various advertisement types. | 279 Destination URL for new advertisements is a valid URL. |
| 280 | 280 |
| 281 The next section allows you to configure IFrames, if you are using them to | 281 In the "Search" section there are two options which are enabled by default. |
| 282 display advertisements. | 282 The first causes advertisements to be removed from local searches when using |
| 283 | 283 Drupal's built in search module. The second causes advertisements to be |
| 284 For better performance, you can also enable a cache. At this time there is | 284 removed from remote search engines by adding the "noindex" meta tag to all |
| 285 only a file cache available. When the file cache is enabled, ads are quickly | 285 pages where node ads are displayed. If you publish advertisement nodes to |
| 286 displayed from a cache file without bootstrapping Drupal. On very busy | 286 the front page mixed in with other content types, you should probably |
| 287 websites you may need to increase the number of cache files to prevent | 287 disable the "Remove ads from remote search engines" option as otherwise |
| 288 cache file contention. | 288 you may find that your entire website is removed from all search engines. |
| 289 (Note that displaying ads on the front page is not the same as displaying | |
| 290 an ad node on the front page. The 'noindex' tag is not added when ads are | |
| 291 displayed via blocks, direct calls to ad(), using views, or when embedded | |
| 292 with the ad_embed module.) | |
| 293 | |
| 294 The "IFrame" section allows you to configure the size of IFrames and other | |
| 295 related settings. | |
| 296 | |
| 297 The "Cache" section provides access to the configuration options for any | |
| 298 enabled ad caching modules. By default the ad module comes with the | |
| 299 file cache which allows advertisements to be quickly and efficiently displayed | |
| 300 from a cache file without bootstrapping Drupal. If your website utilizes | |
| 301 multiple web servers, you should instead download the ad_memcache module | |
| 302 which allows you to serve advertisements from a shared memcache instance. | |
| 289 | 303 |
| 290 --------- | 304 --------- |
| 291 Text ads: | 305 Text ads: |
| 292 --------- | 306 --------- |
| 293 The ad_text module allows you to specify some minimum and maximum lengths for | 307 The ad_text module allows you to specify some minimum and maximum lengths for |