Welcome to Paperwall!
We’re happy to have you join our network, so let’s get your site registered.
Create your site
Simply add the site url and PaperWall will scrape what it can find.
Go to https://paperwall.io/sites and enter your root domain in the big Add Site input bar at the top.
It will create the entry below that input, pre-populating with whatever it could scrape from the site. Click on the title of the newly created entry, which will take you to the verification step.
Verify your site
There are 2 options to verify your site, which approach will depend on your use case, as you will see on the next screen in the wizard - either use the SDK to integrate, or use the pre-made default wall. If you are trying to integrate with an existing paywall, Option 1 is the way to go. If you’re looking for an all-new paywall solution, Option 2 may be your best bet.
You can find more information on configuring Paperwall through the SDK in this guide. You don’t need the complete installation to get up and running, just enough to establish the listeners. The source code can be found at github:paperwall-io/paperwall-lib.
Add the code into a top-level html page where your posts can be found.
The config looks like this:
{
siteToken: "<site-token>",
articleInit: {
selector: 'blog-post', // i.e. <div id="blog-post">...</div>
postUrls: [
/\/posts\/.*/ // [optional] trigger on specific pages
]
}Let’s break that down:
siteToken- a token sent with requests verifying calls to paperwall.ioarticleInit- when initiating per article, this is some optional criteria to support thedetectIsPostfunction.selector- a blog is typically the main article in a site, add the id of the containing article without the#articleEl- this is a regex expression identifying your articles’ path, so Paperwall doesn’t initiate on every page in your site.
If you’re using the default wall, the other required information includes:
integrity- this is an important security measure. It verifies that the Paperwall code has not been modified in any way as it’s injected onto your site. You won’t have to change it, even when Paperwall updates.crossorigin- indicates Paperwall is loaded from an site different from the one it’s hosted on.
When everything is ready, click Verify - this will open a page to your site with a special parameter, which Paperwall will then listen for.
Once the site is verified, the page on Paperwall will replace the Verify page with a dashboard to manage your articles going forward.
Quick and easy dashboard to manage site settings and available articles.
Done!
That’s it! It’s really quick and easy to get started and nothing will show up until you’ve configured and published the articles. In the next post, you can find more information about configuring and setting up articles to collect payments.
If you have any problems, please reach out to our support at paperwall.io/contact and we’ll help you get up and running.