https://github.com/p3ol/react-access
⚛️ The easiest way to add Poool Access to your React app
https://github.com/p3ol/react-access
access paywall poool premium-content react
Last synced: about 1 month ago
JSON representation
⚛️ The easiest way to add Poool Access to your React app
- Host: GitHub
- URL: https://github.com/p3ol/react-access
- Owner: p3ol
- License: mit
- Created: 2020-04-21T07:54:38.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2025-04-21T20:50:02.000Z (about 1 month ago)
- Last Synced: 2025-04-21T21:38:54.026Z (about 1 month ago)
- Topics: access, paywall, poool, premium-content, react
- Language: TypeScript
- Homepage:
- Size: 7.1 MB
- Stars: 4
- Watchers: 2
- Forks: 3
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Authors: AUTHORS
Awesome Lists containing this project
README
[](https://github.com/p3ol/react-access/actions/workflows/ci.yml)
# Poool Access - React SDK
> The easiest way to add Poool Access to your React app ✨
ℹ️ You're looking at the documentation for the v2+ of React Access. If you're looking for v1, please see the [v1 docs](https://github.com/p3ol/react-access/tree/legacy/v1).
## Installation
```bash
yarn add @poool/react-access
```
## Usage
```jsx
import { useRef } from 'react';
import {
AccessContext,
RestrictedContent,
Paywall,
Pixel,
} from '@poool/react-access';
export default = () => {
const contentRef = useRef();
return (
<>
{ /*
Wrap everything with our AccessContext component. Note the withAudit
prop which saves you from writing AuditContext inside of
AccessContext
*/ }
{ /* Wrap your content with our RestrictedContent component */ }
Your article content
{ /*
Place our component where you want your paywall to be
displayed
*/ }
{ /*
Place our component anywhere inside an
component (or ) to track page-view
events (used for native segmentation)
*/ }
>
);
};
```
### Usage with AuditContext
```jsx
import { useRef } from 'react';
import {
AccessContext,
AuditContext,
Paywall,
RestrictedContent,
Pixel,
} from '@poool/react-access';
export default () => {
const contentRef = useRef();
return (
Your article content
);
};
```
## Documentation
### ``
#### Props
- `appId` {`String`} Your Poool App ID
- `config` {`Object`} (optional) Default paywall config (see the [configuration](https://poool.dev/docs/javascript/access/configuration) documentation).
- `styles` {`Object`} (optional) Default paywall styles (see the [styles](https://poool.dev//docs/javascript/access/appearances) documentation).
- `texts` {`Object`} (optional) Default paywall texts (see the [texts](https://poool.dev/docs/javascript/access/texts) documentation).
- `events` {`Object`} (optional) Paywall events listeners (see the [events](https://poool.dev/docs/javascript/access/events) documentation).
- `variables` {`Object`} (optional) Paywall variables (see the [variables](https://poool.dev/docs/javascript/access/variables) documentation).
- `scriptUrl` {`String`} (optional, default: `'https://assets.poool.fr/access.min.js'`) Default Poool Access SDK url
- `scriptLoadTimeout` {`Number`} (optional, default: `2000`) Timeout for the script to load
- `withAudit` {`Boolean`} (optional, default: `false`) Whether to include AuditContext in AccessContext or not
### ``
#### Props
- `appId` {`String`} Your Poool App ID
- `config` {`Object`} (optional) Default audit config (see the [configuration](https://poool.dev/docs/javascript/audit/configuration) documentation).
- `events` {`Object`} (optional) Audit events listeners (see the [events](https://poool.dev/docs/javascript/audit/events) documentation).
- `scriptUrl` {`String`} (optional, default: `'https://assets.poool.fr/audit.min.js'`) Default Poool Audit SDK url
- `scriptLoadTimeout` {`Number`} (optional, default: `2000`) Timeout for the script to load
### ``
#### Props
- `mode` {`String` : `'excerpt'` | `'hide'`| `'custom'`} (optional) Way to hide content see [Access configuration](https://poool.dev/docs/javascript/access/configuration#mode) for more informations.
- `percent` {`Number`} (optional) Percentage of content to hide.
### ``
#### Props
- `contentRef` {`React.Ref`} Reference to the RestrictedContent component associated to this Paywall
- `id` {`String`} (optional, default: random id) Custom wrapper component ID
- `pageType` {`String`} (optional, default: `'premium'`) Current page type (supported types: `page`, `premium`, `free`, `subscription`)
- `config` {`Object`} (optional) Paywall config (see the [configuration](https://poool.dev/docs/javascript/access/configuration) documentation).
- `styles` {`Object`} (optional) Paywall styles (see the [styles](https://poool.dev//docs/javascript/access/appearances) documentation).
- `texts` {`Object`} (optional) Paywall texts (see the [texts](https://poool.dev/docs/javascript/access/texts) documentation).
- `variables` {`Object`} (optional) Paywall variables (see the [variables](https://poool.dev/docs/javascript/access/variables) documentation).
- `events` {`Object`} (optional) Paywall events listeners (see the [events](https://poool.dev/docs/javascript/access/events) documentation)
### ``
#### Props
- `type` {`String`} Event type (supported types: `page-view`)
- `data`{`Object`} (optional but mandatory when type is page-view) Data associated to the event (see the [audit](https://poool.dev/docs/javascript/audit/methods#page-view) documentation)
- `config` {`Object`} (optional) Pixel config (see the [configuration](https://poool.dev/docs/javascript/audit/configuration) documentation).
- `options` {`Object`} (optional) Options to pass to the event (see the [audit](https://poool.dev/docs/javascript/audit/methods#options) documentation)
- `onDone` {`Function`} (optional) Callback to execute when the event is done
- `reuse` {`Boolean`} (optional, default: `false`) Whether to reuse the same event or not
### useAccess()
Can be used to retrieve some properties from the current access context, as well as the Access SDK itself.
#### Returns
- `lib` {`Function`} The entire Access sdk
- `appId` {`String`} Current app ID
- `config` {`Object`} Current access context config
- `texts` {`Object`} Current context texts
- `styles` {`Object`} Current context styles
- `variables` {`Object`} Current context variables
- `events` {`Object`} Current access context events listeners
- `scriptURL` {`Object`} Access SDK url
#### Example
```js
const { appId, lib: access } = useAccess();
```
### useAudit()
Can be used to retrieve some properties from the current audit context, as well as the Audit SDK itself.
#### Returns
- `lib` {`Function`} The entire Audit sdk
- `appId` {`String`} Current app ID
- `config` {`Object`} Current audit context config
- `events` {`Object`} Current audit context events listeners
- `scriptURL` {`Function`} Audit SDK url
#### Example
```js
const { appId, lib: audit } = useAudit();
```
## Contributing
[](https://github.com/p3ol/react-access/graphs/contributors)
Please check the [CONTRIBUTING.md](https://github.com/p3ol/react-access/blob/master/CONTRIBUTING.md) doc for contribution guidelines.
## Development
Install dependencies:
```bash
yarn install
```
Run examples at http://localhost:63000/ with webpack dev server:
```bash
yarn serve
```
And test your code:
```bash
yarn test
```
## License
This software is licensed under [MIT](https://github.com/p3ol/react-access/blob/master/LICENSE).
## v3 -> v4 Migration
**There shouldn't be any migration needed for this version.**
v4 only drops support for Node 16 & yarn < 3.
The project was also migrated to TypeScript, but it shouldn't affect the way you use the library.
## v2 -> v3 Migration
**There shouldn't be any migration needed for this version.**
v3 only drops support for Node 14 & yarn, so unless you want to contribute to this repo using Node 14 or Yarn, you don't have to do anything.
It also drops support for Internet Explorer, but as Access.js already dropped support for IE in 2019, this release only removes some useless IE polyfills.
## v1 -> v2 Migration
- `` has been replaced with `` (used to show the paywall) and `` (used to track particular events)
- `usePoool` has been replaced with `useAccess` and `useAudit`, both respectively requiring the above contexts to be a parent component
- `` now needs a `contentRef` prop to be able to lock/unlock the content, and the ref should be retrieved from ``
- `` has been added to avoid manual event tracking using the legacy `poool()` function
Basic example in v1:
```jsx
import {
PaywallContext,
RestrictedContent,
Paywall,
usePoool,
} from '@poool/react-access';
export default () => {
const { poool } = usePoool();
useEffect(() => {
poool('config', 'context', 'sports');
poool('send', 'page-view', 'premium');
}, []);
return (
test
);
};
```
To be transformed in v2:
```jsx
import { useRef } from 'react';
import {
AccessContext,
RestrictedContent,
Paywall,
Pixel,
} from '@poool/react-access';
export default () => {
const contentRef = useRef();
return (
test
);
};
```