/**
* Returns field definition arrays.
*
* Pass an empty string to the parameter for meta box options.
*
* @return array
*/
public function get($sFieldIDPrefix = '', $aUnitOptions = array())
{
$_oOption = $this->oOption;
$_aFields = array(array('field_id' => $sFieldIDPrefix . 'unit_type', 'type' => 'hidden', 'hidden' => true, 'value' => 'search'), array('field_id' => $sFieldIDPrefix . 'unit_title', 'type' => 'text', 'title' => __('Unit Name', 'amazon-auto-links')), array('field_id' => $sFieldIDPrefix . 'Keywords', 'type' => 'text', 'title' => __('Search Keyword', 'amazon-auto-links'), 'attributes' => array('size' => version_compare($GLOBALS['wp_version'], '3.8', '>=') ? 40 : 60), 'tip' => __('Enter the keyword to search.', 'amazon-auto-links'), 'description' => __('For multiple items, separate them by commas.', 'amazon-auto-links') . ' e.g. <code>WordPress, PHP</code>'), array('field_id' => $sFieldIDPrefix . 'search_per_keyword', 'type' => 'checkbox', 'title' => __('Query per Term', 'amazon-auto-links'), 'tip' => __('Although Amazon API allows multiple search terms to be set per request, when one of them returns an error, the entire result becomes an error. To prevent it, check this option so that the rest will be returned.', 'amazon-auto-links'), 'label' => __('Perform search per item.', 'amazon-auto-links'), 'default' => false), array('field_id' => $sFieldIDPrefix . 'Operation', 'type' => 'hidden', 'title' => __('Operation', 'amazon-auto-links'), 'hidden' => true), array('field_id' => $sFieldIDPrefix . 'country', 'type' => 'text', 'title' => __('Locale', 'amazon-auto-links'), 'attributes' => array('readonly' => 'readonly')), array('field_id' => $sFieldIDPrefix . 'associate_id', 'type' => 'text', 'title' => __('Associate ID', 'amazon-auto-links'), 'description' => 'e.g. <code>miunosoft-20</code>'), array('field_id' => $sFieldIDPrefix . 'SearchIndex', 'type' => 'select', 'title' => __('Category', 'amazon-auto-links'), 'label' => AmazonAutoLinks_Property::getSearchIndexByLocale(isset($aUnitOptions['country']) ? strtoupper($aUnitOptions['country']) : null), 'default' => 'All', 'tip' => __('Select the category to limit the searching area.', 'amazon-auto-links'), 'description' => __('If the above ID Type is ISBN, this will be automatically set to Books.', 'amazon-auto-links') . ' ' . __('If the ID Type is ASIN this option will not take effect.', 'amazon-auto-links')), array('field_id' => $sFieldIDPrefix . 'count', 'type' => 'number', 'title' => __('Number of Items', 'amazon-auto-links'), 'attributes' => array('min' => 1, 'max' => $_oOption->getMaximumProductLinkCount() ? $_oOption->getMaximumProductLinkCount() : null), 'tip' => __('The number of product links to display.', 'amazon-auto-links'), 'default' => 10), array('field_id' => $sFieldIDPrefix . 'image_size', 'type' => 'number', 'title' => __('Image Size', 'amazon-auto-links'), 'after_input' => ' ' . __('pixel', 'amazon-auto-links'), 'delimiter' => '', 'tip' => __('The maximum width of the product image in pixel. Set <code>0</code> for no image.', 'amazon-auto-links'), 'description' => __('Max', 'amazon-auto-links') . ': <code>500</code> ' . ' ' . __('Default', 'amazon-auto-links') . ': <code>160</code>', 'attributes' => array('max' => 500, 'min' => 0), 'default' => 160), array('field_id' => $sFieldIDPrefix . 'Sort', 'title' => __('Sort Order', 'amazon-auto-links'), 'type' => 'radio', 'label' => array('pricerank' => "<strong>" . __('Price Ascending', 'amazon-auto-links') . "</strong> - " . __('Sorts items from the cheapest to the most expensive.', 'amazon-auto-links') . '<br />', 'inversepricerank' => "<strong>" . __('Price Descending', 'amazon-auto-links') . "</strong> - " . __('Sorts items from the most expensive to the cheapest.', 'amazon-auto-links') . '<br />', 'salesrank' => "<strong>" . __('Sales Rank', 'amazon-auto-links') . "</strong> - " . __('Sorts items based on how well they have been sold, from best to worst sellers.', 'amazon-auto-links') . '<br />', 'relevancerank' => "<strong>" . __('Relevance Rank', 'amazon-auto-links') . "</strong> - " . __('Sorts items based on how often the keyword appear in the product description.', 'amazon-auto-links') . '<br />', 'reviewrank' => "<strong>" . __('Review Rank', 'amazon-auto-links') . "</strong> - " . __('Sorts items based on how highly rated the item was reviewed by customers where the highest ranked items are listed first and the lowest ranked items are listed last.', 'amazon-auto-links') . '<br />'), 'default' => 'salesrank', 'description' => __('When the search index is selected to <code>All</code>, this option does not take effect.', 'amazon-auto-links')), array('field_id' => $sFieldIDPrefix . 'ref_nosim', 'type' => 'radio', 'title' => __('Direct Link Bonus', 'amazon-auto-links'), 'label' => array(1 => __('On', 'amazon-auto-links'), 0 => __('Off', 'amazon-auto-links')), 'description' => sprintf(__('Inserts <code>ref=nosim</code> in the link url. For more information, visit <a href="%1$s">this page</a>.', 'amazon-auto-links'), 'https://affiliate-program.amazon.co.uk/gp/associates/help/t5/a21'), 'default' => 0), array('field_id' => $sFieldIDPrefix . 'title_length', 'type' => 'number', 'title' => __('Title Length', 'amazon-auto-links'), 'tip' => __('The allowed character length for the title.', 'amazon-auto-links') . ' ' . __('Use it to prevent a broken layout caused by a very long product title. Set -1 for no limit.', 'amazon-auto-links'), 'description' => __('Default', 'amazon-auto-links') . ": <code>-1</code>", 'default' => -1), array('field_id' => $sFieldIDPrefix . 'description_length', 'type' => 'number', 'title' => __('Description Length', 'amazon-auto-links'), 'tip' => __('The allowed character length for the description.', 'amazon-auto-links') . ' ' . __('Set -1 for no limit.', 'amazon-auto-links'), 'description' => __('Default', 'amazon-auto-links') . ": <code>250</code>", 'default' => 250), array('field_id' => $sFieldIDPrefix . 'link_style', 'title' => __('Link Style', 'amazon-auto-links'), 'type' => 'radio', 'label' => array(1 => 'http://www.amazon.<code>[domain-suffix]</code>/<code>[product-name]</code>/dp/<code>[asin]</code>/ref=<code>[...]</code>?tag=<code>[associate-id]</code>' . " <span class='description'>(" . __('Default', 'amazon-auto-links') . ")</span>", 2 => 'http://www.amazon.<code>[domain-suffix]</code>/exec/obidos/ASIN/<code>[asin]</code>/<code>[associate-id]</code>/ref=<code>[...]</code>', 3 => 'http://www.amazon.<code>[domain-suffix]</code>/gp/product/<code>[asin]</code>/?tag=<code>[associate-id]</code>&ref=<code>[...]</code>', 4 => 'http://www.amazon.<code>[domain-suffix]</code>/dp/ASIN/<code>[asin]</code>/ref=<code>[...]</code>?tag=<code>[associate-id]</code>', 5 => site_url() . '?' . $_oOption->get('query', 'cloak') . '=<code>[asin]</code>&locale=<code>[...]</code>&tag=<code>[associate-id]</code>'), 'before_label' => "<span class='links-style-label'>", 'after_label' => "</span>", 'default' => 1));
$_oCreditFields = new AmazonAutoLinks_FormFields_Unit_Credit();
$_aCreditFields = $_oCreditFields->get($sFieldIDPrefix);
return array_merge($_aFields, $_aCreditFields);
}
/**
* Returns field definition arrays.
*
* Pass an empty string to the parameter for meta box options.
*
* @return array
*/
public function get($sFieldIDPrefix = '', $aUnitOptions = array())
{
$_oOption = $this->oOption;
$aUnitOptions = $aUnitOptions + array('country' => null);
$_bUPCAllowed = 'CA' !== $aUnitOptions['country'];
$_bISBNAllowed = 'US' === $aUnitOptions['country'];
$_aFields = array(array('field_id' => $sFieldIDPrefix . 'unit_type', 'type' => 'hidden', 'hidden' => true, 'value' => 'item_lookup'), array('field_id' => $sFieldIDPrefix . 'unit_title', 'type' => 'text', 'title' => __('Unit Name', 'amazon-auto-links')), array('field_id' => $sFieldIDPrefix . 'ItemId', 'type' => 'textarea', 'title' => __('Item ID', 'amazon-auto-links'), 'attributes' => array('size' => version_compare($GLOBALS['wp_version'], '3.8', '>=') ? 40 : 60), 'description' => __('Enter the ID(s) of the product per line or use the <code>,</code> (comma) characters to delimit the items.', 'amazon-auto-links') . ' e.g. <code>B009ZVO3H6, B0043D2DZA</code>'), array('field_id' => $sFieldIDPrefix . 'search_per_keyword', 'type' => 'checkbox', 'title' => __('Query per Term', 'amazon-auto-links'), 'tip' => __('Although Amazon API allows multiple search terms to be set per request, when one of them returns an error, the entire result becomes an error. To prevent it, check this option so that the rest will be returned.', 'amazon-auto-links'), 'label' => __('Perform search per item.', 'amazon-auto-links'), 'default' => false), array('field_id' => $sFieldIDPrefix . 'IdType', 'type' => 'radio', 'title' => __('ID Type', 'amazon-auto-links'), 'label' => array('ASIN' => 'ASIN', 'SKU' => 'SKU', 'UPC' => '<span class="' . ($_bUPCAllowed ? "" : "disabled") . '">UPC <span class="description">(' . __('Not available in the CA locale.', 'amazon-auto-links') . ')</span></span>', 'EAN' => 'EAN', 'ISBN' => '<span class="' . ($_bISBNAllowed ? "" : "disabled") . '">ISBN <span class="description">(' . __('The US locale only, when the search index is Books.', 'amaozn-auto-links') . ')</span></span>'), 'attributes' => array('UPC' => array('disabled' => $_bUPCAllowed ? null : 'disabled'), 'ISBN' => array('disabled' => $_bISBNAllowed ? null : 'disabled')), 'default' => 'ASIN'), array('field_id' => $sFieldIDPrefix . 'Operation', 'type' => 'hidden', 'hidden' => true, 'value' => 'ItemLookup'), array('field_id' => $sFieldIDPrefix . 'country', 'type' => 'text', 'title' => __('Locale', 'amazon-auto-links'), 'attributes' => array('readonly' => true)), array('field_id' => $sFieldIDPrefix . 'associate_id', 'type' => 'text', 'title' => __('Associate ID', 'amazon-auto-links'), 'description' => 'e.g. <code>miunosoft-20</code>'), array('field_id' => $sFieldIDPrefix . 'SearchIndex', 'type' => 'select', 'title' => __('Categories', 'amazon-auto-links'), 'label' => AmazonAutoLinks_Property::getSearchIndexByLocale(isset($aUnitOptions['country']) ? $aUnitOptions['country'] : null), 'default' => 'All', 'tip' => __('Select the category to limit the searching area.', 'amazon-auto-links'), 'description' => __('If the above ID Type is ISBN, this will be automatically set to Books.', 'amazon-auto-links') . ' ' . __('If the ID Type is ASIN this option will not take effect.', 'amazon-auto-links')), array('field_id' => $sFieldIDPrefix . 'image_size', 'type' => 'number', 'title' => __('Image Size', 'amazon-auto-links'), 'after_input' => ' ' . __('pixel', 'amazon-auto-links'), 'delimiter' => '', 'tip' => __('The maximum width of the product image in pixel. Set <code>0</code> for no image.', 'amazon-auto-links'), 'description' => __('Max', 'amazon-auto-links') . ': <code>500</code> ' . ' ' . __('Default', 'amazon-auto-links') . ': <code>160</code>', 'attributes' => array('max' => 500, 'min' => 0), 'default' => 160), array('field_id' => $sFieldIDPrefix . 'ref_nosim', 'type' => 'radio', 'title' => __('Direct Link Bonus', 'amazon-auto-links'), 'label' => array(1 => __('On', 'amazon-auto-links'), 0 => __('Off', 'amazon-auto-links')), 'description' => sprintf(__('Inserts <code>ref=nosim</code> in the link url. For more information, visit <a href="%1$s">this page</a>.', 'amazon-auto-links'), 'https://affiliate-program.amazon.co.uk/gp/associates/help/t5/a21'), 'default' => 0), array('field_id' => $sFieldIDPrefix . 'title_length', 'type' => 'number', 'title' => __('Title Length', 'amazon-auto-links'), 'tip' => __('The allowed character length for the title.', 'amazon-auto-links') . ' ' . __('Use it to prevent a broken layout caused by a very long product title. Set -1 for no limit.', 'amazon-auto-links'), 'description' => __('Default', 'amazon-auto-links') . ": <code>-1</code>", 'default' => -1), array('field_id' => $sFieldIDPrefix . 'description_length', 'type' => 'number', 'title' => __('Description Length', 'amazon-auto-links'), 'tip' => __('The allowed character length for the description.', 'amazon-auto-links') . ' ' . __('Set -1 for no limit.', 'amazon-auto-links'), 'description' => __('Default', 'amazon-auto-links') . ": <code>250</code>", 'default' => 250), array('field_id' => $sFieldIDPrefix . 'link_style', 'type' => 'radio', 'title' => __('Link Style', 'amazon-auto-links'), 'label' => array(1 => 'http://www.amazon.<code>[domain-suffix]</code>/<code>[product-name]</code>/dp/<code>[asin]</code>/ref=<code>[...]</code>?tag=<code>[associate-id]</code>' . " <span class='description'>(" . __('Default', 'amazon-auto-links') . ")</span>", 2 => 'http://www.amazon.<code>[domain-suffix]</code>/exec/obidos/ASIN/<code>[asin]</code>/<code>[associate-id]</code>/ref=<code>[...]</code>', 3 => 'http://www.amazon.<code>[domain-suffix]</code>/gp/product/<code>[asin]</code>/?tag=<code>[associate-id]</code>&ref=<code>[...]</code>', 4 => 'http://www.amazon.<code>[domain-suffix]</code>/dp/ASIN/<code>[asin]</code>/ref=<code>[...]</code>?tag=<code>[associate-id]</code>', 5 => site_url() . '?' . $_oOption->get('query', 'cloak') . '=<code>[asin]</code>&locale=<code>[...]</code>&tag=<code>[associate-id]</code>'), 'before_label' => "<span class='links-style-label'>", 'after_label' => "</span>", 'default' => 1));
$_oCreditFields = new AmazonAutoLinks_FormFields_Unit_Credit();
$_aCreditFields = $_oCreditFields->get($sFieldIDPrefix);
return array_merge($_aFields, $_aCreditFields);
}
/**
*
* 'Operation' => 'ItemSearch', // ItemSearch, ItemLookup, SimilarityLookup
* @since 2.0.2
* @see http://docs.aws.amazon.com/AWSECommerceService/latest/DG/ItemSearch.html
* @see http://docs.aws.amazon.com/AWSECommerceService/latest/DG/PowerSearchSyntax.html
*/
protected function getAPIParameterArray($sOperation = 'ItemSearch', $iItemPage = null)
{
$_bIsIndexAllOrBlended = 'All' === $this->oUnitOption->get('SearchIndex') || 'Blended' === $this->oUnitOption->get('SearchIndex');
$_sTitle = $this->trimDelimitedElements($this->oUnitOption->get('Title'), ',', false);
$_aParams = array('Keywords' => $this->trimDelimitedElements($this->oUnitOption->get('Keywords'), ',', false), 'Power' => $this->oUnitOption->get('Power'), 'Title' => $_bIsIndexAllOrBlended ? null : ($_sTitle ? $_sTitle : null), 'Operation' => $this->oUnitOption->get('Operation'), 'SearchIndex' => $this->oUnitOption->get('SearchIndex'), $this->oUnitOption->get('search_by') => $this->oUnitOption->get('additional_attribute') ? $this->oUnitOption->get('additional_attribute') : null, 'Sort' => $_bIsIndexAllOrBlended ? null : $this->oUnitOption->get('Sort'), 'ResponseGroup' => "Large", 'BrowseNode' => !$_bIsIndexAllOrBlended && $this->oUnitOption->get('BrowseNode') ? $this->oUnitOption->get('BrowseNode') : null, 'Availability' => $this->oUnitOption->get('Availability') ? 'Available' : null, 'Condition' => $_bIsIndexAllOrBlended ? null : $this->oUnitOption->get('Condition'), 'IncludeReviewsSummary' => "True", 'MaximumPrice' => !$_bIsIndexAllOrBlended && $this->oUnitOption->get('MaximumPrice') ? $this->oUnitOption->get('MaximumPrice') : null, 'MinimumPrice' => !$_bIsIndexAllOrBlended && $this->oUnitOption->get('MinimumPrice') ? $this->oUnitOption->get('MinimumPrice') : null, 'MinPercentageOff' => $this->oUnitOption->get('MinPercentageOff') ? $this->oUnitOption->get('MinPercentageOff') : null, 'MerchantId' => 'Amazon' === $this->oUnitOption->get('MerchantId') ? 'Amazon' : null, 'MarketplaceDomain' => 'Marketplace' === $this->oUnitOption->get('SearchIndex') ? AmazonAutoLinks_Property::getMarketplaceDomainByLocale($this->oUnitOption->get('country')) : null);
$_aParams = $iItemPage ? $_aParams + array('ItemPage' => $iItemPage) : $_aParams;
// 3+ When the Power argument is set, the SearchIndex must not be set.
// and when the SearchIndex is not set, Sort cannot be set.
if ($_aParams['Power']) {
unset($_aParams['Sort']);
}
unset($_aParams['']);
// if ( $_aParams[ 'Title' ] ) {
// unset(
// $_aParams[ 'SearchIndex' ]
// );
// $_aParams[ 'SearchIndex' ] = 'Books';
// }
return $_aParams;
}
/**
* Inserts impression counter scripts.
* @since 3.1.0
*/
public static function _replyToInsertImpressionCounter()
{
foreach (self::$_aImressionCounterSciptLocales as $_sLocale => $_aAssociateTags) {
foreach ($_aAssociateTags as $_sAssociateTag) {
echo str_replace('%ASSOCIATE_TAG%', $_sAssociateTag, AmazonAutoLinks_Property::getImpressionCounterScript($_sLocale));
}
}
}
