{"id":19251627,"url":"https://github.com/tonicpow/widget","last_synced_at":"2025-04-21T13:30:33.665Z","repository":{"id":37091885,"uuid":"321446737","full_name":"tonicpow/widget","owner":"tonicpow","description":"Simple script for using TonicPow with your web applications","archived":false,"fork":false,"pushed_at":"2024-05-21T10:42:50.000Z","size":5339,"stargazers_count":1,"open_issues_count":6,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-05-21T11:50:01.455Z","etag":null,"topics":["advertisements","bitcoinsv","bsv","embed","tonicpow","widget"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tonicpow.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"tonicpow","custom":"https://tonicpow.com/?utm_source=github\u0026utm_medium=sponsor-link\u0026utm_campaign=widget\u0026utm_term=widget\u0026utm_content=widget"}},"created_at":"2020-12-14T19:07:54.000Z","updated_at":"2024-01-12T18:16:55.000Z","dependencies_parsed_at":"2023-02-16T18:01:48.369Z","dependency_job_id":"5af46342-1ebf-4b65-b74c-ab1b6a5192bf","html_url":"https://github.com/tonicpow/widget","commit_stats":null,"previous_names":["tonicpow/embed"],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tonicpow%2Fwidget","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tonicpow%2Fwidget/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tonicpow%2Fwidget/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tonicpow%2Fwidget/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tonicpow","download_url":"https://codeload.github.com/tonicpow/widget/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250064483,"owners_count":21368913,"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":["advertisements","bitcoinsv","bsv","embed","tonicpow","widget"],"created_at":"2024-11-09T18:23:17.876Z","updated_at":"2025-04-21T13:30:33.236Z","avatar_url":"https://github.com/tonicpow.png","language":"TypeScript","readme":"\u003cimg src=\"https://github.com/tonicpow/widget/blob/master/examples/images/tonicpow-logo.png?raw=true\" height=\"100\" alt=\"TonicPow\"\u003e\n\n\u003e Learn more [about TonicPow](https://tonicpow.com/?utm_source=github\u0026utm_medium=link\u0026utm_campaign=widget\u0026utm_term=widget\u0026utm_content=widget). Checkout the [TonicPow API Docs](https://docs.tonicpow.com).\n\n[![last commit](https://img.shields.io/github/last-commit/tonicpow/widget.svg?style=flat\u0026v=1)](https://github.com/tonicpow/widget/commits/master)\n[![npm](https://img.shields.io/npm/v/@tonicpow/widget?v=1)](https://www.npmjs.com/package/@tonicpow/widget)\n[![version](https://img.shields.io/github/release-pre/tonicpow/widget.svg?style=flat\u0026v=1)](https://github.com/tonicpow/widget/releases)\n[![Build Status](https://img.shields.io/github/actions/workflow/status/tonicpow/widget/main-ci.yml?branch=master\u0026logo=github\u0026v=5)](https://github.com/tonicpow/widget/actions)\n[![Mergify Status](https://img.shields.io/endpoint.svg?url=https://api.mergify.com/v1/badges/tonicpow/widget\u0026style=flat\u0026v=3)](https://mergify.io)\n\u003cbr\u003e\n[![Sponsor](https://img.shields.io/badge/sponsor-TonicPow-181717.svg?logo=github\u0026style=flat\u0026v=1)](https://github.com/sponsors/TonicPow)\n[![slack](https://img.shields.io/badge/slack-tonicpow-orange.svg?style=flat\u0026v=1)](https://atlantistic.slack.com/app_redirect?channel=tonicpow)\n\n\n## Table of Contents\n\n- [Features](#Features)\n- [Installation](#installation)\n- [Documentation](#documentation)\n- [Examples](#examples)\n- [Code Standards](#code-standards)\n- [Usage](#usage)\n- [Maintainers](#maintainers)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Features\n\n- Create banner widgets\n- Create share button widgets\n- Manage session tokens for firing conversions\n- Completes TonicPow basic website integration on a campaign\n\n## Installation\n\n1. Add the script to your web application\n\n```html\n\u003cscript src=\"https://tonicpow.com/scripts/tonicpow.js\"\u003e\u003c/script\u003e\n```\n\n2. Insert the widget from your [TonicPow](https://tonicpow.com/?utm_source=github\u0026utm_medium=sponsor-link\u0026utm_campaign=widget\u0026utm_term=widget\u0026utm_content=widget) account:\n\n```html\n\u003cdiv class=\"tonicpow-widget\" data-widget-id=\"your-widget-id-here\"\u003e\u003c/div\u003e\n```\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e\u003ccode\u003eGet Visitor Session\u003c/code\u003e\u003c/strong\u003e\u003c/summary\u003e\n\n```javascript\nlet session = window.TonicPow.getVisitorSession()\nconsole.log(session) // 1b40c235dd9532213f5d611ffz06f9dd018efeffad8d6fbc35dc421fed18babz\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e\u003ccode\u003eBuild From Scratch\u003c/code\u003e\u003c/strong\u003e\u003c/summary\u003e\n\n```shell script\nmake install\nmake build\n```\n\n\u003c/details\u003e\n\n\u003cbr/\u003e\n\n## Documentation\n\nRead more about the [TonicPow API](https://docs.tonicpow.com/?utm_source=github\u0026utm_medium=sponsor-link\u0026utm_campaign=widget\u0026utm_term=widget\u0026utm_content=widget) platform.\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e\u003ccode\u003eSupported Browsers\u003c/code\u003e\u003c/strong\u003e\u003c/summary\u003e\n\nTonicPow supports all commonly used browsers. Below is a list of popular browsers and their minimum supported version.\nIf we're missing a browser, suggest one [via an issue](https://github.com/tonicpow/widget/issues/new).\n\n| Browser | Platform | Min Version |\n| :------ | :------- | :---------- |\n| Android | Mobile   | 67.0        |\n| Bottle  | Desktop  | 0.1         |\n| Brave   | Desktop  | 55.0        |\n| Chrome  | Desktop  | 55.0        |\n| Chrome  | Mobile   | 74.0        |\n| Edge    | Desktop  | 17.0        |\n| Firefox | Desktop  | 52.0        |\n| Firefox | Mobile   | 67.0        |\n| IE      | Desktop  | ---         |\n| Opera   | Desktop  | 42.0        |\n| Opera   | Mobile   | ---         |\n| Safari  | Desktop  | 10.1        |\n| Safari  | Mobile   | 10.3        |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e\u003ccode\u003eLibrary Deployment\u003c/code\u003e\u003c/strong\u003e\u003c/summary\u003e\n\n[goreleaser](https://github.com/goreleaser/goreleaser) for easy binary or library deployment to Github and can be installed via: `brew install goreleaser`.\n\nThe [.goreleaser.yml](.goreleaser.yml) file is used to configure [goreleaser](https://github.com/goreleaser/goreleaser).\n\nUse `make release-snap` to create a snapshot version of the release, and finally `make release` to ship to production.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e\u003ccode\u003eMakefile Commands\u003c/code\u003e\u003c/strong\u003e\u003c/summary\u003e\n\nView all `makefile` commands\n\n```shell script\nmake help\n```\n\nList of all current commands:\n\n```text\naudit                Checks for vulnerabilities in dependencies\nbuild                Builds the package for web distribution\nclean                Remove previous builds and any test cache data\ninstall              Installs the dependencies for the package\nlint                 Runs the standard-js lint tool\noutdated             Checks for outdated packages via npm\npublish              Will publish the version to npm\nrelease              Deploy to npm\ntest                 Runs all tests\nhelp                 Show this help message\nrelease              Full production release (creates release in Github)\nrelease-test         Full production test release (everything except deploy)\nrelease-snap         Test the full release (build binaries)\nreplace-version      Replaces the version in HTML/JS (pre-deploy)\ntag                  Generate a new tag and push (tag version=0.0.0)\ntag-remove           Remove a tag if found (tag-remove version=0.0.0)\ntag-update           Update an existing tag to current commit (tag-update version=0.0.0)\n```\n\n\u003c/details\u003e\n\n\u003cbr/\u003e\n\n## Examples\n\nView some [example TonicPow widgets](/examples/basic/basic-example.html)\n\n\u003cbr/\u003e\n\n### Unit Tests\n\nRun the unit tests:\n\n```shell script\nmake test\n```\n\n\u003cbr/\u003e\n\n## Code Standards\n\nAlways use the language's best practices and don't optimize early :P\n\n\u003cbr/\u003e\n\n## Usage\n\nWe are using it! Visit [our website](https://tonicpow.com/?utm_source=github\u0026utm_medium=sponsor-link\u0026utm_campaign=widget\u0026utm_term=widget\u0026utm_content=widget) to see it in action.\n\n\u003cbr/\u003e\n\n## Maintainers\n\n| [\u003cimg src=\"https://github.com/mrz1836.png\" height=\"50\" alt=\"MrZ\" /\u003e](https://github.com/mrz1836) | [\u003cimg src=\"https://github.com/rohenaz.png\" height=\"50\" alt=\"Satchmo\" /\u003e](https://github.com/rohenaz) |\n| :----------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------: |\n|                                [MrZ](https://github.com/mrz1836)                                 |                                [Satchmo](https://github.com/rohenaz)                                 |\n\n\u003cbr/\u003e\n\n## Contributing\n\nView the [contributing guidelines](.github/CONTRIBUTING.md) and follow the [code of conduct](.github/CODE_OF_CONDUCT.md).\n\n### How can I help?\n\nAll kinds of contributions are welcome :raised_hands:!\nThe most basic way to show your support is to star :star2: the project, or to raise issues :speech_balloon:.\nYou can also support this project by [becoming a sponsor on GitHub](https://github.com/sponsors/TonicPow) :clap:\nor by making a [**bitcoin donation**](https://tonicpow.com/?utm_source=github\u0026utm_medium=sponsor-link\u0026utm_campaign=widget\u0026utm_term=widget\u0026utm_content=widget) to ensure this journey continues indefinitely! :rocket:\n\n[![Stars](https://img.shields.io/github/stars/tonicpow/widget?label=Please%20like%20us\u0026style=social)](https://github.com/tonicpow/widget/stargazers)\n\n\u003cbr/\u003e\n\n## License\n\n[![License](https://img.shields.io/badge/license-Open%20BSV-brightgreen.svg?style=flat\u0026v=1)](/LICENSE)\n","funding_links":["https://github.com/sponsors/tonicpow","https://tonicpow.com/?utm_source=github\u0026utm_medium=sponsor-link\u0026utm_campaign=widget\u0026utm_term=widget\u0026utm_content=widget","https://github.com/sponsors/TonicPow"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftonicpow%2Fwidget","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftonicpow%2Fwidget","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftonicpow%2Fwidget/lists"}