{"id":29292890,"url":"https://github.com/tarosky/taro-ad-fields","last_synced_at":"2026-05-19T03:37:05.686Z","repository":{"id":80335219,"uuid":"96412058","full_name":"tarosky/taro-ad-fields","owner":"tarosky","description":"An Adblock manager for WordPress","archived":false,"fork":false,"pushed_at":"2025-06-27T06:45:49.000Z","size":1248,"stargazers_count":0,"open_issues_count":10,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-06-27T07:42:29.109Z","etag":null,"topics":["advertising","wordpress","wordpress-plugin","wordpress-plugin-published"],"latest_commit_sha":null,"homepage":"https://wordpress.org/plugins/taro-ad-fields/","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tarosky.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-07-06T09:19:17.000Z","updated_at":"2025-06-26T02:31:30.000Z","dependencies_parsed_at":"2025-04-08T06:22:00.500Z","dependency_job_id":"e3fd4159-9423-4bd5-8c63-a38e282e83d4","html_url":"https://github.com/tarosky/taro-ad-fields","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/tarosky/taro-ad-fields","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tarosky%2Ftaro-ad-fields","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tarosky%2Ftaro-ad-fields/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tarosky%2Ftaro-ad-fields/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tarosky%2Ftaro-ad-fields/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tarosky","download_url":"https://codeload.github.com/tarosky/taro-ad-fields/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tarosky%2Ftaro-ad-fields/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263882342,"owners_count":23524469,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["advertising","wordpress","wordpress-plugin","wordpress-plugin-published"],"created_at":"2025-07-06T10:11:49.467Z","updated_at":"2026-05-19T03:37:05.678Z","avatar_url":"https://github.com/tarosky.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Taro Ad Fields\n\nTags: advertisement  \nContributors: tarosky, Takahashi_Fumiki, yocchi161, tswallie  \nTested up to: 6.8  \nStable tag: nightly  \nLicense: GPLv3 or later  \nLicense URI: http://www.gnu.org/licenses/gpl-3.0.txt\n\nAdvertise block manager for WordPress.\n\n## Description\n\nYou can create ad slot for you WordPress theme.\nIn each position, the latest ad field will be displayed.\nYou can manage your advertisement's schedule \u0026 display!\n\n### From Theme\n\nCall action hook in your theme:\n\n\u003cpre\u003e\n\u0026lt;?php do_action( 'taro_ad_field', 'after-header', '\u0026lt;div class=\"after-header\"\u0026gt;', '\u0026lt;/div\u0026gt;', 3 ); ?\u0026gt;\n\u003c/pre\u003e\n\nIn this place, the latest 3 ads will be displayed.\nWith [Taro Clockwork Post](https://wordpress.org/plugins/taro-clockwork-post/) plugin, you can let your ad be automatically expired.\n\n#### Hook Arguments\n\n\u003ccode\u003edo_action( $hook_name, $slug, $before, $after, $number );\u003e\u003c/code\u003e\n\n1. **$hook_name**: The action hook name. Always should be `taro_ad_field`.\n2. **$slug**: Slug of position.\n3. **$before**: String to be output just before ad block. If no ad exists, this won't be displayed.\n4. **$after**: String to be output just after ad block.\n5. **$number**: Number of ad to be displayed. Default is 1.\n6. **$contexts**: Array of contexts. Context is a taxonomy that filters ads. For more details, see our [Wiki](https://github.com/tarosky/taro-ad-fields/wiki).\n\n### From Widget\n\nWe also have widget for ad field. The latest ad of specified position will be displayed in the widget.\n\n### Set Default Positions\n\nIn your theme, add filter hook for `taf_default_positions`.\nThese terms will be created automatically.\n\n\u003cpre\u003e\nadd_filter( 'taf_default_positions', function() {\n\treturn [\n\t\t'after-header' =\u003e [\n\t\t\t'name' =\u003e 'After Header',\n\t\t\t'description' =\u003e 'Displayed just after header.',\n\t\t],\n\t\t'after-content' =\u003e [\n\t\t\t'name' =\u003e 'After Content',\n\t\t\t'description' =\u003e 'Displayed just after content.',\n\t\t\t'mode' =\u003e 'iframe',\n\t\t],\n\t];\n} );\n\u003c/pre\u003e\n\nDefaults are empty array, so no default position.\nYou can add new position to them with filter hook like above.\nThe structure of array will be like below:\n\n\u003cpre\u003e\n[\n  'slug_name' =\u003e [\n    'name'        =\u003e 'Verbose Position Name',\n    'description' =\u003e 'About where will be displayed(up to you)',\n    'mode'        =\u003e 'iframe',\n  ],\n]\n\u003c/pre\u003e\n\nIf you set mode as 'iframe', this position will have URL and display ad in very simple HTML pages.\nYou can get URL from view link in position list of admin screen.\n\nThis feature is useful to deliver ad in external platform like [Facebook Instant Article](https://instantarticles.fb.com).\n\n## Installation\n\n1. Upload the plugin files to the `/wp-content/plugins/taro-ad-fields` directory, or install the plugin through the WordPress plugins screen directly.\n2. Activate the plugin through the 'Plugins' screen in WordPress\n3. Go to `Ad Field \u003e Position` and create positons. If you set default positions with filters, they will be automatically generated.\n4. Register ad posions. The published fields will be displayed.\n\n## Frequently Asked Questions\n\n### Do you have detailed documentaiton?\n\nPlease check our [Wiki](https://github.com/tarosky/taro-ad-fields/wiki). English and Japanese documentations are available.\n\n### How to Contribute\n\nWe host our code on [Github](https://github.com/tarosky/taro-ad-fields), so feel free to send PR or issues.\n\n### Is there any vulnerability?\n\nAs far as we know, **NO**. But nothing is perfect.\nThis plugin allows you to save Javascript like Google Adsense code,\nso please be careful about who can edit your ad.\nYou can customize the capability for ad fields by hooking `taf_post_type_args` filter.\n\n## Screenshots\n\nW.I.P\n\n## Changelog\n\n### 1.3.2\n\n* Add context feature.\n\n### 1.2.6\n\n* Add filter hook for widget rendering.\n\n### 1.2.5\n\n* Allow multiple ad in one field.\n\n### 1.1.0\n\n* Add iframe feature. Now you can provide ad field as iframe ad container. e.g. Facebook Instant Article.\n\n### 1.0.0\n\n* First Release.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftarosky%2Ftaro-ad-fields","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftarosky%2Ftaro-ad-fields","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftarosky%2Ftaro-ad-fields/lists"}