FAIR

Federated and Independent Repositories

Build Natively

Plugin Banner

Build Natively

by buildnatively

Download
Description

Build Natively helps language learners by loading the Natively frontend script on your WordPress site. Once the plugin is installed and activated, it automatically adds the required scripts to the head of your pages.

What it does:

  • Loads the bundled Natively frontend script in the head (async)
  • Enables debug mode so you can see any errors in the browser console
  • No configuration needed — activate and it works

Source code for bundled JavaScript

This plugin includes a minified copy of the Natively frontend script (natively-frontend.min.js, version 2.14.0) for compatibility with the WordPress.org guidelines. The human-readable source code is not maintained in this plugin; it is part of the Natively library.

Public source code:

  • GitHub (source repository): https://github.com/buildnatively/js-sdk
  • npm package: https://www.npmjs.com/package/natively (version 2.14.0 or later)

You can review, study, and build from source at the links above. The bundled file in this plugin is the built frontend from that library.

External services

This plugin loads the Natively frontend script, which may connect to the following third-party or external services. Use of these services is governed by their respective terms and privacy policies.

1. Natively / Build Natively

  • What it is and what it’s used for: Build Natively / Natively provides language learning and reading features (e.g. translations, vocabulary, reading assistance). The frontend script may communicate with Build Natively or Natively servers to power these features.
  • What data is sent and when: Data may be sent when visitors use language learning features on your site (e.g. page or text they are reading, language preferences). The exact data depends on how the Natively script is used; see the service’s documentation for details.
  • Terms of use: https://www.buildnatively.com/terms-of-use
  • Privacy policy: https://www.buildnatively.com/privacy-policy

2. OneSignal

  • What it is and what it’s used for: The bundled Natively library includes code that can connect to OneSignal for push notifications. This is used only if the site or the Natively integration is configured to use push notifications.
  • What data is sent and when: If push notifications are enabled, data such as device or browser identifiers and notification preferences may be sent to OneSignal when users interact with notification features.
  • Terms of service: https://onesignal.com/tos
  • Privacy policy: https://onesignal.com/privacy_policy

By installing this plugin, you acknowledge that your site may communicate with these services as described. Ensure your site’s privacy policy and any consent mechanisms comply with applicable law.

  1. Upload the plugin files to /wp-content/plugins/buildnatively/, or install the plugin through the WordPress Plugins screen.
  2. Activate the plugin through the Plugins screen in WordPress.
  3. The Natively script will load in the head of your site automatically.
Do I need an API key or account?

Check Natively documentation for any account or API requirements for the frontend script.

The script is not loading

Ensure your theme calls wp_head(). Open the browser console (F12) and look for errors; debug mode is enabled by default.

1.0.0

  • Initial release.
  • Loads natively-frontend.min.js (v2.14.0) in head with async and onload.
  • Enables window.natively.setDebug(true) for troubleshooting.
Back to top