Infrastructure/ghost
0
Fork 0
mirror of https://github.com/TryGhost/Ghost.git synced 2025-03-11 02:12:21 -05:00
Code Issues Activity

Updated readme

Browse source 
no refs
This commit is contained in:
Rish 2021-03-17 22:34:00 +05:30
parent ed5d975087
commit 627b2238da
1 changed files with 16 additions and 16 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

32
ghost/portal/README.md
View file

@ -7,24 +7,15 @@ Drop-in script to make the bulk of Ghost membership features work on any theme.
## Usage ## Usage
Portal can be enabled on any theme directly by adding the below script in your theme's `default.hbs` just before the end of body tag OR in the code injection footer in Ghost Admin. Ghost automatically injects this Portal script on all sites running Ghost 4 or higher.
Alternatively, Portal can be enabled on non-ghost pages directly by inserting the below script on the page.
```html ```html
<script defer src="https://unpkg.com/@tryghost/portal@latest/umd/portal.min.js" data-ghost="https://mymemberssite.com"></script> <script defer src="https://unpkg.com/@tryghost/portal@latest/umd/portal.min.js" data-ghost="https://mymemberssite.com"></script>
``` ```
The `data-ghost` attribute expects the URL for your site which is the only input Portal needs to work with your site's membership data via Ghost APIs. The `data-ghost` attribute expects the URL for your site, which is the only input Portal needs to work with your site's membership data via Ghost APIs.
Alternatively, Ghost automatically injects this Portal script to any site behind a dedicated flag(see below) which can be added via config, which also enables Site owner/admins to customize specific Portal settings from Ghost-Admin.
NOTE: Since this is currently under active development, Portal can be switched on with a new dedicated flag - `portal` - in [Ghost config](https://ghost.org/docs/concepts/config/), which needs to be added to config file before starting the server.
```json
{
...,
"portal": true
}
```
### Custom trigger button ### Custom trigger button
@ -60,10 +51,17 @@ Only useful for active UI development without publishing a version on unpkg. Alw
#### In your theme(Ex. Lyra): #### In your theme(Ex. Lyra):
- Copy `portal.min.js` from above and paste it in your theme at `assets/built/portal.min.js` - Copy `portal.min.js` from above and paste it in your theme at `assets/built/portal.min.js`
- Add below code in your theme's `default.hbs` just before end of body tag
```html #### In Ghost repo
<script src='{{asset "built/portal.min.js"}}'></script>
- Update your `config.local.json` to add "portal" config which points url to the locally built copy.
```json
...,
"portal": {
"url": "SITE_URL/assets/built/portal.min.js"
},
...
``` ```
## Available Scripts ## Available Scripts
@ -97,6 +95,8 @@ Run `yarn ship` to publish new version of script.
- Builds the script with latest code using `yarn build` (prePublish) - Builds the script with latest code using `yarn build` (prePublish)
- Publishes package on npm as `@tryghost/portal` and creates an unpkg link for script at https://unpkg.com/@tryghost/portal@VERSION - Publishes package on npm as `@tryghost/portal` and creates an unpkg link for script at https://unpkg.com/@tryghost/portal@VERSION
(Core team only)
## Learn More ## Learn More
This project was bootstrapped with [Create React App](https://github.com/facebook/create-react-app). This project was bootstrapped with [Create React App](https://github.com/facebook/create-react-app).