Fumiki Takahashi

TAROSKY INC.

yocchi161

<p>You can create ad slot for you WordPress theme.<br />
In each position, the latest ad field will be displayed.<br />
You can manage your advertisement’s schedule & display!</p>
<h4>From Theme</h4>
<p>Call action hook in your theme:</p>
<pre>
<?php do_action( 'taro_ad_field', 'after-header', '<div class="after-header">', '</div>', 3 ); ?>
</pre>
<p>In this place, the latest 3 ads will be displayed.<br />
With <a href="https://wordpress.org/plugins/taro-clockwork-post/" rel="ugc">Taro Clockwork Post</a> plugin, you can let your ad be automatically expired.</p>
<p>Hook Arguments</p>
<pre><code>do_action( $hook_name, $slug, $before, $after, $number );>
</code></pre>
<ol>
<li><strong>$hook_name</strong>: The action hook name. Always should be <code>taro_ad_field</code>.</li>
<li><strong>$slug</strong>: Slug of position.</li>
<li><strong>$before</strong>: String to be output just before ad block. If no ad exists, this won’t be displayed.</li>
<li><strong>$after</strong>: String to be output just after ad block.</li>
<li><strong>$number</strong>: Number of ad to be displayed. Default is 1.</li>
<li><strong>$contexts</strong>: Array of contexts. Context is a taxonomy that filters ads. For more details, see our <a href="https://github.com/tarosky/taro-ad-fields/wiki" rel="nofollow ugc">Wiki</a>.</li>
</ol>
<h4>From Widget</h4>
<p>We also have widget for ad field. The latest ad of specified position will be displayed in the widget.</p>
<h4>Set Default Positions</h4>
<p>In your theme, add filter hook for <code>taf_default_positions</code>.<br />
These terms will be created automatically.</p>
<pre>
add_filter( 'taf_default_positions', function() {
    return [
        'after-header' => [
            'name' => 'After Header',
            'description' => 'Displayed just after header.',
        ],
        'after-content' => [
            'name' => 'After Content',
            'description' => 'Displayed just after content.',
            'mode' => 'iframe',
        ],
    ];
} );
</pre>
<p>Defaults are empty array, so no default position.<br />
You can add new position to them with filter hook like above.<br />
The structure of array will be like below:</p>
<pre>
[
  'slug_name' => [
    'name'        => 'Verbose Position Name',
    'description' => 'About where will be displayed(up to you)',
    'mode'        => 'iframe',
  ],
]
</pre>
<p>If you set mode as ‘iframe’, this position will have URL and display ad in very simple HTML pages.<br />
You can get URL from view link in position list of admin screen.</p>
<p>This feature is useful to deliver ad in external platform like <a href="https://instantarticles.fb.com" rel="nofollow ugc">Facebook Instant Article</a>.</p>


Taro Ad Fields

miunosoft

Michael Uno

<h4>Display Amazon Associates Affiliate Links with Minimal Effort</h4>
<p>Still manually searching products and pasting Amazon affiliate links in WordPress posts? What happens if the products get outdated? With this plugin, you do not have to worry about it nor trouble doing such repetitive tasks. Just pick categories that suit your site and it will automatically display the links of decent products just coming out from Amazon today.</p>
<p>Auto Amazon Links is a WordPress plugin for affiliates to create Amazon affiliate links. The links are tagged with your Amazon Associates ID. All the Amazon locales are supported and it works even on JavaScript-disabled browsers. Insert the ads as widget, place shortcode, or use auto-insert to display units automatically where the links should appear.</p>
<p>If you want to search for a specific product, yes, you can do that too. If you are good at HTML and CSS coding and know a little about PHP, you can create your own template! That means you can design the layout.</p>
<p>Display Amazon affiliate links along with your posts with this plugin to earn commissions with minimal effort.</p>
<h4>Display a particular product in a post</h4>
<p>If you want to simply display your desired specific products in a post, don’t worry. You can do that too. Just paste the product URL into the post editor. No shortcode is required.</p>
<h4>See How Amazon Affiliate Links are Displayed</h4>
<span class="embed-youtube" style="text-align:center; display: block;"><iframe loading="lazy" class="youtube-player" width="750" height="422" src="https://www.youtube.com/embed/mpDCcp4KBZg?version=3&rel=1&showsearch=0&showinfo=1&iv_load_policy=1&fs=1&hl=en-US&autohide=2&wmode=transparent" allowfullscreen="true" style="border:0;" sandbox="allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox"></iframe></span>
<h4>Supporting All the Amazon Associates Locales</h4>
<p>Includes Australia, Brazil, Belgium, Canada, China, Egypt, France, Germany, India, Italy, Japan, Mexico, Netherlands, Poland, Singapore, Saudi Arabia, Spain, Sweden, Turkey, United Arab Emirates, United Kingdom, and the United States. China is supported for the category unit type.</p>
<h4>Works without JavaScript</h4>
<p>Some visitors turn off JavaScript in their browsers for security reasons and most ads including Google Adsense will not show up to them. But this one works!</p>
<h4>Automatic Insertion in Posts and Feeds</h4>
<p>Just check where you want the product links to appear with auto-insert.</p>
<ul>
<li><strong>Static Contents Conversion</strong> – If you want the product link to be static, it is possible. This means that if you deactivate the plugin, the converted contents will remain.</li>
<li><strong>Detailed Visibility Criteria</strong> – You can enable/disable product links on the pages you want or do not want by post ID, taxonomy, page type, and post type.</li>
</ul>
<h4>Customizable Buttons</h4>
<p>Your site visitors are more likely to click buttons than regular text hyperlinks. Define your custom buttons and insert them into the unit output.</p>
<p>The plugin lets you design buttons through UI and prepares several default buttons for you so that you can modify them rather than create your own from scratch.</p>
<h4>Geo-targeting</h4>
<p>You can transform your Amazon affiliate links into the ones of the locale that the site visitor resides, presumed by IP address. So you won’t miss commission fees from visitors coming outside of your country.</p>
<h4>Auto Link Conversion</h4>
<p>Hyperlinks to Amazon products in posts and comments can be transformed into your associate affiliate links. This is useful if your site allows guests to post contents that include Amazon links.</p>
<h4>Gutenberg Block</h4>
<p>The plugin has a Gutenberg block that lets you pick units you created, which can save a little time than typing the shortcode.</p>
<h4>Widgets</h4>
<p>Place the widget in the sidebar and select the unit you created. The product links will appear where you want.</p>
<ul>
<li><strong>By Units</strong> – choose the created units to display in the widget.</li>
<li><strong>Contextual Search</strong> – with this, you don’t have to create a unit. It will automatically search products relating to the currently displayed page contents.</li>
</ul>
<h4>Shortcode and PHP Function</h4>
<p>Insert the ads in specific posts and pages with the shortcode. If you want to insert in the theme template, use the PHP code the plugin provides to produce the outputs.</p>
<h4>Filtering Products</h4>
<p>You can filter out certain products you don’t want to display with a black and white list by description, title, and ASIN.</p>
<h4>RSS and JSON Unit Feeds</h4>
<p>By subscribing to the product RSS/JSON feeds of the units you create, you can import them from other sites.</p>
<p>If you have a website that can display RSS feed contents, just create a WordPress site somewhere with this plugin and fetch the feed from the site. If you are an App developer, you can just display the items from the feed without programming an API client.</p>
<h4>Various Unit Options</h4>
<ul>
<li><strong>Image Size</strong> – The size of thumbnails can be specified. It supports up to 500 pixels large with a clean resolution.</li>
<li><strong>Sort Order</strong> – Shuffle the product links so that the visitor won’t get bored as it gives refreshed impression.</li>
<li><strong>URL cloaking</strong> – You can obfuscate the link URLs so it helps to prevent being blocked by browser Ad-blocking add-ons.</li>
<li><strong>Load with Javascript</strong> – Decides whether to display units with JavaScript.</li>
<li>and more.</li>
</ul>
<h4>Customizing Outputs</h4>
<p>Besides the <strong>Item Format</strong> unit option which lets you design the output of a unit, you can create a custom template. This gives you freedom of customization and lets you achieve a more advanced and detailed design.</p>
<h4>Unit Types</h4>
<ul>
<li><strong>Category</strong> – picks your category that matches your site topic.</li>
<li><strong>Product Search</strong> – creates a unit by performing product searches.</li>
<li><strong>URL</strong> – lists items from an external web source.</li>
<li><strong>PA-API Product Search</strong> – creates a unit of a search result using PA-API.</li>
<li><strong>PA-API Item Look-up</strong> – displays specific products.</li>
<li><strong>PA-API Custom Payload</strong> – is for more complex PA-API queries.</li>
</ul>
<h4>Supported Languages</h4>
<ul>
<li>English</li>
<li>Japanese</li>
<li>German</li>
<li>Italian</li>
<li>Spanish</li>
</ul>
<h4>Getting Started</h4>
<p>Please see the <strong>Installation</strong> section.</p>
<h4>Shortcode and Function Parameters</h4>
<p>The plugin provides means to display Amazon product links by manually inserting a piece of code into your post or a theme file. For posts, it’s called <em>shortcode</em>. For theme files, you need to place a PHP function. Using these, you even don’t have to create a unit.</p>
<ul>
<li>Shortcode:
<ul>
<li><code>[amazon_auto_links]</code></li>
</ul>
</li>
<li>PHP Functions:
<ul>
<li><code>do_action( 'aal_action_output' );</code></li>
<li><code>apply_filters( 'aal_filter_output' );</code></li>
</ul>
</li>
</ul>
<p>They both takes the following arguments.</p>
<p><strong>id</strong> – the unit ID</p>
<pre><code>[amazon_auto_links id="123"]
<?php do_action( 'aal_action_output', array( 'id' => 123 ) ); ?>
<?php echo apply_filters( 'aal_filter_output', '', array( 'id' => 123 ) ); ?>
</code></pre>
<p><strong>label</strong> – the label associated with the units</p>
<pre><code>[amazon_auto_links label="WordPress"]
<?php do_action( 'aal_action_output', array( 'label' => 'WordPress' ) ); ?>
<?php echo apply_filters( 'aal_filter_output', '', array( 'label' => 'WordPress' ) ); ?>
</code></pre>
<p><strong>asin</strong> – ASINs (product IDs) separated by commas (`,`).</p>
<pre><code>[amazon_auto_links asin="B016ZNRC0Q, B00ZV9PXP2"]
<?php do_action( 'aal_action_output', array( 'asin' => 'B016ZNRC0Q, B00ZV9PXP2' ) ); ?>
<?php echo apply_filters( 'aal_filter_output', '', array( 'asin' => 'B016ZNRC0Q, B00ZV9PXP2' ) ); ?>
</code></pre>
<p><strong>search</strong> – Search keywords separated by commas (`,`).</p>
<pre><code>[amazon_auto_links search="WordPress"]
<?php do_action( 'aal_action_output', array( 'search' => 'WordPress' ) ); ?>
<?php echo apply_filters( 'aal_filter_output', '', array( 'search' => 'WordPress' ) ); ?>
</code></pre>
<p>When the <code>search</code> argument is specified, the following arguments can be used.</p>
<ul>
<li><code>SearchIndex</code> – Filters search results by category. For accepted values, see the <a href="https://webservices.amazon.com/paapi5/documentation/locale-reference.html#topics" rel="nofollow ugc">locale reference</a>. For example, the <a href="https://webservices.amazon.com/paapi5/documentation/locale-reference/united-states.html#search-index" rel="nofollow ugc">US locale</a>, e.g. <code>[amazon_auto_links search="Oven" SearchIndex="Electronics"]</code></li>
<li><code>Sort</code>/<code>SortBy</code> – (PA-API required) Sort order. Accepts the following values: <code>AvgCustomerReviews</code>, <code>Featured</code>, <code>NewestArrivals</code>, <code>Price:HighToLow</code>, <code>Price:LowToHigh</code>, <code>Relevance</code>. For the details of each value, see <a href="https://webservices.amazon.com/paapi5/documentation/search-items.html#sortby-parameter" rel="nofollow ugc">here</a>. e.g. <code>[amazon_auto_links search="WordPress" sort="AvgCustomerReviews"]</code></li>
<li><code>BrowseNode</code>/<code>BrowseNodeId</code> – (PA-API required) Filters search results by category ID.</li>
<li><code>Availability</code> – (PA-API required) Filters search results to items with the specified product availability status. Accepts <code>Available</code> or <code>IncludeOutOfStock</code>. See <a href="https://webservices.amazon.com/paapi5/documentation/search-items.html#availability-parameter" rel="nofollow ugc">details</a>.</li>
<li><code>MerchantId</code>/<code>Merchant</code> – (PA-API required) Filters search results to items with the specified merchant. See <a href="https://webservices.amazon.com/paapi5/documentation/search-items.html#merchant-parameter" rel="nofollow ugc">details</a>.</li>
<li><code>Condition</code> – (PA-API required) Filters search results to items with the specified product condition. Accepts <code>Any</code>, <code>New</code>, <code>Used</code>, <code>Collectible</code> or <code>Refurbished</code>. See <a href="https://webservices.amazon.com/paapi5/documentation/search-items.html#condition-parameter" rel="nofollow ugc">details</a>.</li>
<li><code>MaximumPrice</code>/<code>MaxPrice</code> – (PA-API required) Filters search results to items with a price below the specified price. The value needs to be formatted in lowest currency denomination. For example, in the US marketplace, set <code>1234</code> for $12.34.</li>
<li><code>MinimumPrice</code>/<code>MinPrice</code> – (PA-API required) Filters search results to items with a price above the specified price. The value needs to be formatted in lowest currency denomination. For example, in the US marketplace, set <code>1234</code> for $12.34.</li>
<li><code>MinPercentageOff</code>/<code>MinSavingPercent</code> – (PA-API required) Filters search results to items with a specified discount percentage. e.g. <code>[amazon_auto_links search="shoes" MinSavingPercent=20]</code> where <code>20</code> denotes 20 percent-off.</li>
<li><code>MinReviewsRating</code> – (PA-API required) Filters search results to items with a customer rating above the specified value. Accepts a positive integer from <code>2</code> to <code>5</code>. e.g. <code>[amazon_auto_links search="shoes" MinReviewsRating=4]</code> for products with a rating above 4.</li>
<li><code>CurrencyOfPreference</code> – (PA-API required) Preferred currency. For accepted values, see the <a href="https://webservices.amazon.com/paapi5/documentation/locale-reference.html" rel="nofollow ugc">locale reference</a>.</li>
<li><code>LanguagesOfPreference</code> – (PA-API required) Preferred language specified in the ISO 639 language code. For accepted values, see the <a href="https://webservices.amazon.com/paapi5/documentation/locale-reference.html" rel="nofollow ugc">locale reference</a>.</li>
</ul>
<p>The <code>id</code>, <code>asin</code> and <code>search</code> arguments cannot be used together.</p>
<p>These shortcode argument names are case-insensitive, meaning <code>maxprice</code> is also accepted for <code>MaxPrice</code>.</p>
<p>Optionally, the following arguments may be set.</p>
<ul>
<li><code>country</code> – (string) the locale of the store. Accepted values are <code>CA</code>, <code>CN</code>, <code>FR</code>, <code>DE</code>, <code>IT</code>, <code>JP</code>, <code>UK</code>, <code>ES</code>, <code>US</code>, <code>IN</code>, <code>BR</code>, <code>MX</code>, <code>AU</code>, <code>TR</code>, <code>AE</code>, <code>SG</code>, <code>SE</code>, and <code>NL</code>.</li>
<li><code>associate_id</code> – (string) the Amazon Associates ID for the affiliate.</li>
<li><code>count</code> – (integer) determines how many items should be displayed.</li>
<li><code>image_size</code> – (integer) the image size in pixels.</li>
<li><code>title_length</code> – (integer) the maximum title character length. Set <code>-1</code> for no limit. Default: <code>-1</code>.</li>
<li><code>description_length</code> – (integer) the maximum description character length. Set <code>-1</code> for no limit. Default: <code>250</code>.</li>
<li><code>link_style</code> – (integer) the link style. Accepted values are <code>1</code>, <code>2</code>, <code>3</code>, <code>4</code>, and <code>5</code>. Default: <code>1</code>.
<ul>
<li><code>1</code> – http://www.amazon.[domain-suffix]/[product-name]/dp/[asin]/ref=[…]?tag=[associate-id]</li>
<li><code>2</code> – http://www.amazon.[domain-suffix]/exec/obidos/ASIN/[asin]/[associate-id]/ref=[…]</li>
<li><code>3</code> – http://www.amazon.[domain-suffix]/gp/product/[asin]/?tag=[associate-id]&ref=[…]</li>
<li><code>4</code> – http://www.amazon.[domain-suffix]/dp/ASIN/[asin]/ref=[…]?tag=[associate-id]</li>
<li><code>5</code> – http://localhost/wp47?productlink=[asin]&locale=[…]&tag=[associate-id]</li>
</ul>
</li>
<li><code>credit_link</code> – (integer|boolean) whether to show the credit link. <code>1</code>/<code>true</code> to show, <code>0</code>/<code>false</code> to hide.</li>
<li><code>subimage_size</code> – (integer) the sub-image size in pixels. Default: <code>100</code>.</li>
<li><code>subimage_max_count</code> – (integer) the maximum number of sub-images to display.</li>
<li><code>customer_review_max_count</code> – (integer) the maximum number of customer reviews.</li>
<li><code>show_now_retrieving_message</code> – (boolean|integer) whether to show the “Now retrieving…” message when sub-elements are pending to be fetched. <code>true</code>/<code>1</code> to show <code>false</code>/<code>0</code> to hide.</li>
<li><code>button_type</code> – (integer) The type of buttons. The following values are accepted. Default: <code>1</code>.
<ul>
<li><code>0</code> – Link to the product page.</li>
<li><code>1</code> – Add to cart.</li>
</ul>
</li>
<li><code>load_with_javascript</code> – [3.6.0+] (boolean|integer) whether to load the unit with JavaScript. <code>true</code>/<code>1</code> to yes, <code>false</code>/<code>0</code> to no.</li>
<li><code>product_title</code> – [4.0.0+] (string) An alternative text to alter the product title for anchor text. This is only supported when the <code>asin</code> argument is set.</li>
<li><code>show_errors</code> – [4.1.0+] (integer) Whether to show the output error. Default: <code>2</code>.
<ul>
<li><code>0</code>: do not show error.</li>
<li><code>1</code>: show the error.</li>
<li><code>2</code>: show the error in an HTML comment.</li>
</ul>
</li>
</ul>
<p>These values can be pre-defined from the setting page via <strong>Dashboard</strong> -> <strong>Auto Amazon Links</strong> -> <strong>Settings</strong> -> <strong>Default</strong>.<br />
If these arguments are omitted, the values set on the setting page will be used.</p>
<h4>Shortcode to Display Buttons</h4>
<p>Although the <code>%button%</code> tag in the <code>Item Format</code> unit option allows you to insert a button, the button can be displayed independently with the shortcode, <code>[aal_button ...]</code>.</p>
<p>It accepts the following parameters.</p>
<ul>
<li><code>asin</code> – (required, string) Comma delimited ASINs.</li>
<li><code>type</code> – (optional, integer) 0: Link to the product page, 1: Add to cart button. Default: <code>1</code>.</li>
<li><code>id</code> – (optional, integer) The button ID. To use the button created via Dashboard -> Auto Amazon Links -> Manage Buttons, specify the button ID.</li>
<li><code>quantity</code> – (optional, integer) The quantity of the item to add to cart. When multiple ASINs are specified, separate the values by commas.</li>
<li><code>country</code> – (optional, string) The locale of the marketplace. If not set, the default value set in the Default setting tab will be applied.</li>
<li><code>associate_id</code> – (optional, string) The associate tag. If not set, the default value set in the Default setting tab will be applied.</li>
<li><code>access_key</code> – (optional, string) The public PA-API key. If not set, the default value set in the Associates tab will be applied.</li>
<li><code>label</code> – (optional, string) The button label. e.g. ‘Buy Now’. Default: <code>Buy Now</code>.</li>
<li><code>offer_listing_id</code> – (optional, scalar) An offer listing id that Amazon gives.</li>
</ul>
<h4>Creating Your Own Template</h4>
<p>Download the zip file from the <a href="https://github.com/michaeluno/amazon-auto-links-example-templates" rel="nofollow ugc">example templates</a> repository. Make sure it runs as a plugin and a few example templates are loaded in the template listing screen (Dashboard -> Auto Amazon Links -> Templates).</p>
<p>Follow the steps described in readme.md of the linked repository and start modifying them. You want to:<br />
 – rename the root directory, <code>amazon-auto-links-example-templates</code><br />
 – rename the template directory names, <code>lightslider</code> and <code>minimal</code><br />
 – rename the main plugin file name, <code>amazon-auto-links-example-templates.php</code><br />
 – rename PHP namespaces, <code>AutoAmazonLinks\Templates\Examples</code><br />
 – replace <code>screenshot.jpg</code> in the template directory<br />
 – replace the header comment of <code>style.css</code> in the template directory<br />
 – modify CSS rules of <code>style.css</code></p>
<h4>Obtaining PA-API Access Key and Secret Key</h4>
<p>To display more detailed product information, PA-API is required. A pair of access and secret key is required to perform API requests.</p>
<p>To get the keys,</p>
<ol>
<li>login to <a href="https://affiliate-program.amazon.com/" rel="nofollow ugc">Amazon Associates</a> of your locale.</li>
<li>From the navigation menu at the top, navigate to Tools -> Product Advertising API.</li>
<li>If you haven’t used it before, press the Join button. An access and a secret key should be issued and displayed after that.</li>
</ol>
<p>You can check if your keys are valid with <a href="https://webservices.amazon.com/paapi5/scratchpad/" rel="nofollow ugc">Scratchpad</a>.</p>


Auto Amazon Links – Amazon Associates Affiliate Plugin

Generates Amazon affiliate links of products just coming out today. Pick categories and they appear even in JavaScript-disabled browsers.

Taro Ad Fields vs Auto Amazon Links – Amazon Associates Affiliate Plugin