peertube-plugin-sell-storage 1.1.4 → 1.1.6

package/README.md

@@ -3,7 +3,9 @@
 ## Table of Contents
 
 - [About](#about)
-- [Getting Started](#getting_started)
+- [Prerequisites](#prerequisites)
+- [Installation](#installation)
+- [Configuration](#configuration)
 - [Usage](#usage)
 
 ## About <a name = "about"></a>
@@ -11,69 +13,104 @@
 
 This plugin allows you to sell storage space to your users using Stripe subscription. Payments are automated with Stripe.
 
-## Getting Started <a name = "getting_started"></a>
+This is a fork of [peertube-plugin-ncd-sell-storage](https://gitea.nicecrew.digital/matty/peertube-plugin-ncd-sell-storage). The most notable improvements are:
+- Error free! **At the time of writing this**, the published version of ncd-sell-storage is outdated and therefore does not work despite the fix being available on their Git repository.
+- Branding removed. ncd-sell-storage had hardcoded branding which was removed so this plugin is accessible by everyone.
+- Custom billing portal for customers to manage their subscriptions.
+- Imrpoved documentation. For example, the necessary API events for the Stripe webhook are documented.
 
-This is a fork of [peertube-plugin-ncd-sell-storage](https://gitea.nicecrew.digital/matty/peertube-plugin-ncd-sell-storage). Unfortunately, the published version on NPM is outdated **at the time of writing this** and therefore does not work despite the fix being available on their Git repository. For that reason, their repository was forked and published separately with the updated code.
+As with [peertube-plugin-ncd-sell-storage](https://gitea.nicecrew.digital/matty/peertube-plugin-ncd-sell-storage), this fork allows you to add five different packages/subscriptions.
 
-Additionally, this plugin removes branding and allows users to set their own billing portal for customers.
-
-As with [peertube-plugin-ncd-sell-storage](https://gitea.nicecrew.digital/matty/peertube-plugin-ncd-sell-storage), this fork allows you to add five packages rather than three.
-
-Check [Prerequisites](#Prerequisites) to install this plugin
-
-### Prerequisites
+## Prerequisites <a name="prerequisites"></a>
 
+- Stripe API key
+- Stripe webhook (see the [Configuration](#configuration) section)
+- Stripe products (up to 5) for users to subscribe to
 - Peertube >= v4.3.0
 
-### Installing
+## Installation <a name="installation"></a>
 
 - Go to your instance Admin
 - Navigate to the "Plugins" page
 - Search for "sell-storage"
 - Click Install near the plugin name
 
-## If installing locally
+### If you're installing locally
  - Clone Git repository
  - cd peertube-plugin-sell-storage
  - yarn
  - yarn build
  - Install via PeerTube CLI
 
-### Configuration
-You need to configuration the plugin to work.
+## Configuration <a name="configuration"></a>
+You need a Stripe account as stated in the [Prerequisites](#prerequisites) section.
 Create an account on https://stripe.com to start.
 
 
-In your Stripe dashboard, you can test in "Test mode", and go live by unchecking "Test mode" in the top right.
-To go in live mode, you need to fill form in Stripe side. We recommand you to test in Test mode the integration before go in live.
+Once you've validated your email and inputted your business details, you can test in "Test mode", and go live by unchecking "Test mode". This option is found by hovering over your business name in the top left.
+<img width="712" height="433" alt="image" src="https://github.com/user-attachments/assets/f9ee2825-45ab-4ae4-8402-2c26acba01b5" />
 
-### Note: If you perform a transaction in Test Mode, you'll need to manually clear the subscription status because the webhook will not send back the correct validation response, meaning the changes will take effect but nothing will be charged. Use a dedicated test account.
+We recommend you to test the plugin in "Test mode" before going into "Live mode" (i.e. dealing with real money).
 
-First, go to the Developer tab, and navigate to "API Keys". Grab your Secret API key, and insert it in your plugin settings.
+**Note: If you perform a transaction in Test Mode, you'll need to manually clear the subscription status because the webhook will not send back the correct validation response, meaning the changes will take effect but nothing will be charged. Use a dedicated test account.**
 
-After that, always in the Developer tab, navigate to Webhook and create a webhook with the following API events:
-- `checkout.session.completed`
+### API Keys
+
+You need the Secret API Key to add to the plugin configuration. Navigate to https://dashboard.stripe.com/apikeys. Copy and paste the Secret API Key into the plugin settings.
+
+<img width="1524" height="327" alt="image" src="https://github.com/user-attachments/assets/250e4f8e-3652-4582-b710-6d57882b3fa2" />
+
+
+### Webhook configuration
+
+Go to https://dashboard.stripe.com/webhooks and create a webhook with the following API events:
 - `customer.subscription.created`
 - `customer.subscription.deleted`
 - `customer.subscription.trial_will_end`
 - `customer.subscription.updated`
+- `checkout.session.completed`
 - `invoice.paid`
 - `invoice.payment_failed`
 - `payment_intent.succeeded`
 
-An example of webhook URL is available in your plugin settings. An example is also shown here:
-https://your-instance.tld/plugins/sell-storage/1.1.3/router/webhook
+For the webhook URL, make sure the version in the URL matches the version of the plugin. For example, if your plugin is on version `1.1.6` use the URL:
+`https://your-instance.tld/plugins/sell-storage/1.1.6/router/webhook`
 
-### Note: If you update the plugin, you'll have to update the webhook link in Stripe with the new version. For example, update 1.1.3 to 1.1.4. Don't forget this!
+An example of this with the correct version in the webhook URL is available in the plugin settings.
 
-Now, configure your billing portal, currency, page and description in the plugin settings.
+**Note: If you update the plugin, you'll have to update the webhook link in Stripe with the new version. For example, if you update from 1.1.3 to 1.1.6 change the webhook URL to `https://your-instance.tld/plugins/sell-storage/1.1.6/router/webhook`. Don't forget this!**
 
-Its time to add your Plans! In stripe, go to Product page, and add new product. Set a name, description and the price.
-After creation, go in this new Product and grab the "API ID" near the price field.
+### PeerTube Plugin
 
-Now, you can continue configure your Plan (1, 2, 3, 4, 5) in the plugin settings.
-Repeat this process for each plans. Add new product, and grab the API ID corresponding to this price to insert it in your Product ID field, in the plugin settings.
+Configure the following settings:
+- Billing portal URL (enabled and customised at https://dashboard.stripe.com/settings/billing/portal)
+- Currency
+- Page description, thank you page description and cancel page description.
+
+### Plan configuration
+It's time to add your plans!
+
+1. In stripe, go to https://dashboard.stripe.com/products and add a new product. Set a name, description and price.
+After creation, click on the product and click on the binocular icon at the bottom right.
+<img width="405" height="62" alt="image" src="https://github.com/user-attachments/assets/8b5f95f8-e20a-4cb2-b9e4-872c48ae86e5" />
+
+&nbsp;
+
+2. On the left side of the inspection window, click on the price key.
+<img width="395" height="300" alt="image" src="https://github.com/user-attachments/assets/c20b5320-f88c-4c4f-820b-f9188b84efde" />
+
+&nbsp;
+
+3. On the right side of the inspection window, copy the price ID into the respective plan in the plugin settings.
+<img width="436" height="319" alt="image" src="https://github.com/user-attachments/assets/017ced89-6ab5-4b53-8565-93bf1ec0c5f5" />
+
+&nbsp;
+
+Repeat steps 1-3 for each plan (1, 2, 3, 4, 5) in the plugin settings.
 
 ## Usage <a name = "usage"></a>
 
-- Navigate to "Storage Plan" underneath "My video space" in the PeerTube menu
+Navigate to "Storage Plan" underneath "My video space" in the PeerTube menu
+
+<img width="212" height="258" alt="image" src="https://github.com/user-attachments/assets/05d4b7a2-0964-4bf2-9981-251f32b162b3" />
+

package/main.js

@@ -376,7 +376,7 @@ function registerMenuSettings(registerSetting) {
     label: "Stripe Billing Portal",
     type: "input",
     private: false,
-    descriptionHTML:" "The Stripe billing portal where customers can manage their subscriptions. Enabled at: https://dashboard.stripe.com/settings/billing/portal",
+    descriptionHTML: "The Stripe billing portal where customers can manage their subscriptions. Enabled at: https://dashboard.stripe.com/settings/billing/portal",
     default: ""
   });
 
@@ -400,7 +400,7 @@ function registerMenuSettings(registerSetting) {
     type: "markdown-enhanced",
     private: false,
     descriptionHTML: "You can explain what you want, it is showed on the page. Leave it empty to show default localized description.",
-    default: "You **want tu spport us** ? Or **need more space** ? Your in the right place!"
+    default: "If you need more storage space, please contact us using the contact form."
   });
 
   registerSetting({
@@ -409,7 +409,7 @@ function registerMenuSettings(registerSetting) {
     type: "markdown-enhanced",
     private: false,
     descriptionHTML: "If you want to show a text on the Success page after payment",
-    default: ""
+    default: "Thanks for your support!"
   });
 
   registerSetting({
@@ -418,7 +418,7 @@ function registerMenuSettings(registerSetting) {
     type: "markdown-enhanced",
     private: false,
     descriptionHTML: "If you want to show a text on the Cancel page after payment canceled",
-    default: ""
+    default: "Have a great rest of your day!"
   });
 
 
@@ -440,7 +440,7 @@ function registerMenuSettings(registerSetting) {
     type: "input",
     private: false,
     descriptionHTML: "Specify the name of your plan",
-    default: "Starter plan",
+    default: "Starter Plan",
   });
 
   registerSetting({
@@ -457,7 +457,7 @@ function registerMenuSettings(registerSetting) {
     label: "Plan price /month",
     type: "input",
     private: false,
-    descriptionHTML: "Specify the price /month users pay for this plan",
+    descriptionHTML: "Specify the price per month users pay for this plan",
     default: 5,
   });
 
@@ -482,7 +482,7 @@ function registerMenuSettings(registerSetting) {
     type: "input",
     private: false,
     descriptionHTML: "Specify the name of your plan",
-    default: "Community plan",
+    default: "Community Plan",
   });
 
   registerSetting({
@@ -499,7 +499,7 @@ function registerMenuSettings(registerSetting) {
     label: "Plan price /month",
     type: "input",
     private: false,
-    descriptionHTML: "Specify the price /month users pay for this plan",
+    descriptionHTML: "Specify the price per month users pay for this plan",
     default: 10,
   });
 
@@ -523,7 +523,7 @@ function registerMenuSettings(registerSetting) {
     type: "input",
     private: false,
     descriptionHTML: "Specify the name of your plan",
-    default: "Profesionnal plan",
+    default: "Professional Plan",
   });
 
   registerSetting({
@@ -540,7 +540,7 @@ function registerMenuSettings(registerSetting) {
     label: "Plan price /month",
     type: "input",
     private: false,
-    descriptionHTML: "Specify the price /month users pay for this plan",
+    descriptionHTML: "Specify the price per month users pay for this plan",
     default: 15,
   });
 
@@ -564,7 +564,7 @@ function registerMenuSettings(registerSetting) {
       type: "input",
       private: false,
       descriptionHTML: "Specify the name of your plan",
-      default: "Profesionnal plan",
+      default: "Professional Plan",
     });
   
     registerSetting({
@@ -581,7 +581,7 @@ function registerMenuSettings(registerSetting) {
       label: "Plan price /month",
       type: "input",
       private: false,
-      descriptionHTML: "Specify the price /month users pay for this plan",
+      descriptionHTML: "Specify the price per month users pay for this plan",
       default: 15,
     });
   
@@ -605,7 +605,7 @@ function registerMenuSettings(registerSetting) {
     type: "input",
     private: false,
     descriptionHTML: "Specify the name of your plan",
-    default: "Profesionnal plan",
+    default: "Professional Plan",
   });
 
   registerSetting({
@@ -622,7 +622,7 @@ function registerMenuSettings(registerSetting) {
     label: "Plan price /month",
     type: "input",
     private: false,
-    descriptionHTML: "Specify the price /month users pay for this plan",
+    descriptionHTML: "Specify the price per month users pay for this plan",
     default: 15,
   });
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "peertube-plugin-sell-storage",
   "description": "Updated and republished version of peertube-plugin-ncd-sell-storage to sell storage to users using Stripe",
-  "version": "1.1.4",
+  "version": "1.1.6",
   "author": "AyaaDev",
   "bugs": "https://github.com/ayaadev/peertube-plugin-sell-storage",
   "clientScripts": [