WordPress.org
Get WordPress

Plugin Directory

Changeset 958446


Ignore:
Timestamp:
08/01/2014 03:31:43 AM (12 years ago)
Author:
switzer
Message:

updating documentation with better instructions, bumping version

Location:
advertising-manager/trunk
Files:
3 edited

Legend:

Unmodified
Added
Removed

  • advertising-manager/trunk/advertising-manager.php

    r956361 r958446  
    66Author: Scott Switzer
    77Author URI: http://github.com/switzer
    8 Version: 3.4.26
     8Version: 3.4.27
    99Text Domain: advman
    1010Domain Path: /languages
    … …  
    2929
    3030
    31     define('ADVMAN_VERSION', '3.4.26');
     31    define('ADVMAN_VERSION', '3.4.27');
    3232    define('ADVMAN_PATH', dirname(__FILE__));
    3333    define('ADVMAN_LIB', ADVMAN_PATH . '/lib/Advman');

  • advertising-manager/trunk/deploy.txt

    r958424 r958446  
    77php ../../tools/i18n/makepot.php wp-plugin .
    88mv ./advertising-manager.pot ./languages
    9 svn ci languages/advertising-manager.pot -m "Updated i18n source file"
    10 
    11   NEW:
    12     1.  Generate a translation pot template here:
    13     http://wordpress.org/plugins/advertising-manager/admin/?action=pot
    14 
    15     2. Sign into Transifex and add the pot file by going to:
    16     https://www.transifex.com/projects/p/advertising-manager/resources/
    17     and clicking on ‘add new resource.’
    18 
    19   COMPLETED:
    20     1. On Advertising Manager Overview page, click on the translation language, then on
    21     the pot template
    22    
    23     2. Download for translation
    24     NOTE: ‘Download for translation’ generates a po file consisting of everything in the
    25     pot file.
    26     ‘Download only reviewed translations’ generates a po file consisting of only the
    27     translations that were saved and reviewed.
    28 
    29     3. Copy po file to /languages, then add and commit file:
    30     svn add advman-lang.po
    31     svn commit -m “adding new translation files”
    32 
    33     4. Convert po file to mo file:
    34     msgfmt -o advman-lang.po advman-lang.mo
    35 
    36     5. Commit mo files:
    37     svn commit -m “adding new mo files”
     9tx pull -a
     10cd ~/code/wordpress/advertising-manager/trunk/languages
     11msgfmt -o advman-ar.mo advman-ar.po
     12msgfmt -o advman-de_DE.mo advman-de_DE.po
     13msgfmt -o advman-el.mo advman-el.po
     14msgfmt -o advman-en_US.mo advman-en_US.po
     15msgfmt -o advman-es_ES.mo advman-es_ES.po
     16msgfmt -o advman-hu_HU.mo advman-hu_HU.po
     17msgfmt -o advman-id_ID.mo advman-id_ID.po
     18msgfmt -o advman-ja.mo advman-ja.po
     19msgfmt -o advman-ko_KR.mo advman-ko_KR.po
     20msgfmt -o advman-pt_BR.mo advman-pt_BR.po
     21msgfmt -o advman-ru_RU.mo advman-ru_RU.po
     22msgfmt -o advman-th.mo advman-th.po
     23msgfmt -o advman-tr.mo advman-tr.po
     24svn ci . -m "Updated i18n languages and source files"
    3825
    3926
    … …  
    4128    1.  in the comments at the top of advertising-manager.php
    4229    2.  in the code at the top of advertising-manager.php
    43     3.  in the readme file
    44     4.  in this build file (search for the version number 3.4.26 - there are a number of places in this file where the version exists)
    45     5.  check the upgrade to make sure any version upgrades are correct
     30    3.  in the readme file (stable tag at the top)
     31    4.  In the readme file (Changelog)
     32    5.  in this build file (search for the version number 3.4.27 - there are a number of places in this file where the version exists)
     33    6.  check the upgrade to make sure any version upgrades are correct
    4634
    4735README
    … …  
    6048- Tag the version in wordpress
    6149    cd ~/code/wordpress/advertising-manager
    62     svn cp trunk tags/3.4.26
    63     svn ci -m "tagging version 3.4.26"
     50    svn cp trunk tags/3.4.27
     51    svn ci -m "tagging version 3.4.27"
    6452
    6553- Add a zipped file to the repository:
    … …  
    7159    svn export http://svn.wp-plugins.org/advertising-manager/trunk
    7260    mv trunk advertising-manager
    73     zip -r advertising-manager-3.4.26.zip advertising-manager/
     61    zip -r advertising-manager-3.4.27.zip advertising-manager/
    7462   
    7563    http://code.openx.org/projects/list_files/advertising-manager

  • advertising-manager/trunk/readme.txt

    r956365 r958446  
    55Requires at least: 2.5
    66Tested up to: 3.9.1
    7 Stable tag: 3.4.26
     7Stable tag: 3.4.27
     8License: GPLv2 or later
    89
    910Easily place and rotate ads on inside your blog posts, templates, or sidebar widgets. Simple to use, powerful features.  Used by thousands of blogs.
    … …  
    3233== Installation ==
    3334
    34 1. Unzip the package and upload the advertising-manager directory into your wp-content/plugins directory
    35 1. Activate the plugin at the plugin administration page
    36 1. Add your ad networks by clicking 'Create new' under the 'Ads' menu.  Manage your ad networks by clicking 'Edit' under the 'Ads' menu.
     351. Under the 'Plugins' menu in your Wordpress Admin console, click 'Add New'.
     361. Search for 'advertising-manager'.
     371. The first item should be 'Advertising Manager' by Scott Switzer.  Click the 'Install Now' button.
     381. Click 'Ok' if an alert box appears.
     391. After the plugin installs, click 'Activate Plugin'.
     40
     41== Usage ==
     42
     431. Add your ads by clicking 'Create New' under the 'Ads' menu.
    37441. Place ads in your template by adding '<?php advman_ad(name) ?>' to your template in the place you want to see an ad (where 'name' is the name of your ad).
    38451. Place ads in your blog posts and pages by adding '[ad#name]' to your blog post (where 'name' is the name of your ad), or by using the 'Insert Ad' dropdown from the edit toolbar.
    … …  
    6471= Can Advertising Manager work in my language? =
    6572Yes.  Advertising Manager is localised.  If your blog is in another language, and Advertising Manager shows in English, then it is most likely that a translation has not been done.
    66 Don't worry - if you are a native speaker in English as well as your local language, you can help out!  Information on how to get involved can be found here:
    67 
    68 NOTE:  Translations are in the process of being upgraded to a new technology - updated instructions will happen in the next version
     73Don't worry - if you are a native speaker in English as well as your local language, you can help out!  Advertising Manager translations can be updated here:
     74
     75https://www.transifex.com/projects/p/advertising-manager/
    6976
    7077= Do I still need Advertising Manager now I can manage ads through Google's system? =
    7178
    72 Yes.  Advertising manager allows you to rotate ads, easily turn on/off ads, place them in your blog, and many features other than configuration of the ad colors and format.  It a critical tool to use if you want to make more from your advertising.
    73 
    74 = Why does changing Ad Format/Dimensions sometimes not change the size of the ad? =
    75 
    76 For some ad networks (e.g. newer Adsense tags, WidgetBucks, Adroll, etc.) the dimensions of ads are managed through the online interface. There is no way to change these settings from within the WordPress system that would work reliably. You do not have to update these dimension settings if you update your Ad online, however, it can be useful in correctly identifying 'Alternate Ads' for AdSense blocks.
    77 
    78 = How do I place Ad code at the top, bottom, left, right, etc. of the page? =
    79 
    80 There is a (nice tutorial here)[http://www.tamba2.org.uk/wordpress/adsense/] which explains positioning using code in template files. You can use this together with Advertising Manager: just place the ad code tags <?php advman_ad('name'); ?> where it says "place code here".
     79Yes.  Advertising manager allows you to rotate ads, easily turn on/off ads, place them in your blog, and many other features.  It a critical tool to use if you want to make more from your advertising.
    8180
    8281= How can I share revenue with my authors? =
    … …  
    87861.  In your author's ad, be sure to select the authors username in Display Options
    88871.  Set the weights of the ads according to your revenue share.  The easiest way to do this is to set YOUR ad weight to 36, and then set the weight of your author's ad according to the revenue share deal.  For 10% revenue share, set the author ad weight to 4; 20% = 9; 33% = 18; 40% = 24; 50% = 36; 60% = 54; 66.7% = 72; 70% = 84; 80% = 144; 90% = 324.  For the nerdy wonks out there, the formula is (AUTHOR AD WEIGHT) = (MY AD WEIGHT * REVENUE SHARE) / (1 - REVENUE SHARE)
    89 
    90 More detailed instuctions can be found in the documentation:  [Concepts - Placing ads on your blog](http://code.openx.org/wiki/advertising-manager/Placing_ads_on_your_blog)
    9188
    9289
    … …  
    10198* Add ability to show in an email
    10299* Send daily and weekly statistics information
    103 * Add version information to the footer in admin screens of advman
    104100
    105101
    106102== Upgrade Notice ==
    107103
    108 = 3.4.26 =
    109 * Allowed default ad to be toggled from ad list again
    110 * Changed Ad.js URL to be from CDN
     104= 3.4.27 =
     105* Updated translations to use Transifex (https://www.transifex.com/projects/p/advertising-manager/)
     106* Updated deployment instructions with new translation methodology
    111107
    112108== Change Log ==
     109
     110= 3.4.27 =
     111* Updated translations to use Transifex (https://www.transifex.com/projects/p/advertising-manager/)
     112* Updated deployment instructions with new translation methodology
    113113
    114114= 3.4.26 =
    … …  
    250250This plugin is released under the GPL - you can use it free of charge on your personal or commercial blog. Make sure to submit back to the project any changes that you make!
    251251
     252
    252253== Translations ==
    253254
    254 The plugin comes with various translations, please refer to the WordPress Codex for more information about activating the translation. If you want to help to translate the plugin to your language, please have a look at the advman.pot file which contains all defintions and may be used with a [gettext](http://www.gnu.org/software/gettext/) editor like [Poedit](http://www.poedit.net/) (Windows).
     255Advertising Manager is translated into several different languages.  If a translation is missing or incomplete, and you want to help, please head over to the [Advertising Manager Transifex](https://www.transifex.com/projects/p/advertising-manager/) project to help with your translation.
Note: See TracChangeset for help on using the changeset viewer.