Description
Freestar Ads connects a WordPress site to your existing Freestar advertising account. Enter the site slug Freestar gave you, choose who should see ads, and the plugin loads Freestar’s pubfig.js tag with the correct attributes and connection hints. It can also keep your ads.txt current by redirecting it to the copy Freestar maintains for you.
This plugin is an interface to Freestar, an external advertising service. It does nothing until you connect it, and it requires a Freestar publisher account to be useful.
Features
- Loads the Freestar
pubfig.jsad tag and its companion stylesheet withasyncanddata-cfasync="false", pluspreconnecthints for the ad delivery hosts. - Accepts a slug or a domain. Periods and other non-alphanumeric characters become dashes, so
welcome.freestar.comresolves towelcome-freestar-com. The settings screen previews the exact URL before you save. - Restrict ads to administrators only, so you can verify placements before going live.
- Optional Dynamic Ads.txt support: answers requests for
/ads.txtwith a 301 to your Freestar-hosted file, with a built-in check that reports what a crawler actually receives. - Never injects tags into
wp-admin, and suppresses them on WooCommerce checkout pages.
External service: Freestar
This plugin relies on Freestar, a third-party advertising service operated by Freestar, and on Blockthrough, a separate third party used by the ad tag for ad-block recovery. You need a Freestar publisher account to use it.
No external host is contacted until you press the “I’m a Freestar Publisher” button in the plugin settings. Until then the settings screen shows nothing but that button and this disclosure, the plugin adds nothing to your pages, and it makes no outbound requests, not even connection hints. The date, time, and user who connected are recorded, and a “Disconnect from Freestar” button at the foot of the settings screen stops all external contact again.
Once connected, and only once you have also entered your site slug, visitors’ browsers contact the following hosts:
a.pub.network— serves thepubfig.jsad tag, its stylesheet, and the hostedads.txtfile.b.pub.network,c.pub.network,d.pub.network— Freestar ad delivery and site configuration.btloader.comandapi.btloader.com— Blockthrough ad-block recovery, a separate third-party service loaded by the ad tag.
Serving advertising inherently involves processing visitor data. Freestar and its advertising partners may process information including IP address, device and browser details, approximate location, pages viewed, and advertising identifiers such as cookies. The plugin itself sends no data to Freestar from your server; the requests are made by your visitors’ browsers when the tag loads.
If you enable the ads.txt option, requests to your /ads.txt are redirected to a.pub.network, which means the requesting client (usually an advertising crawler) contacts Freestar.
Service and policy links:
- Service: https://freestar.com/
- Freestar privacy policy: https://freestar.com/privacy-policy/
- Publisher privacy information: https://freestar.com/privacy-policies-for-publishers/
You are responsible for disclosing this in your own privacy policy and for obtaining any visitor consent your jurisdiction requires. The plugin adds suggested wording to the WordPress privacy policy tool under Settings Privacy to help you get started. This plugin does not and cannot guarantee legal compliance.
Screenshots


Installation
- Upload the plugin to
/wp-content/plugins/, or install it through the Plugins screen. - Activate it through the Plugins screen.
- Go to Settings Freestar.
- Read the disclosure and press I’m a Freestar Publisher to connect. The remaining settings appear only after this.
- Enter the site slug Freestar provided, choose your audience, and save.
FAQ
-
Do I need a Freestar account?
-
Yes. The plugin is an interface to the Freestar advertising service and has no standalone functionality without an account.
-
Does the plugin do anything before I configure it?
-
No. It contacts no external servers and adds nothing to your pages until you press the connect button and enter a slug. Before you connect, the settings screen shows only the disclosure and that button.
-
Where do I find my site slug?
-
Freestar provides it. It is normally your domain with periods replaced by dashes, such as
welcome-freestar-com. You can paste your domain into the field and the plugin will convert it. -
Why is my ads.txt redirect not working?
-
A real
ads.txtfile in your WordPress root is served directly by your web server, so WordPress never sees the request. Remove or rename it. The settings screen detects this and names the file. Note also thatads.txtis only valid at the domain root, so a WordPress install served from a subdirectory cannot answer for it. -
Can I preview ads without showing them to visitors?
-
Yes. Set Load ads for to Administrators only. The ads.txt redirect stays active either way, because advertising crawlers need to reach it.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Freestar Ads” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Freestar Ads” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial release.
