Downloading and Installation

Follow these steps to install the LearnTier LMS - Subscription Addon for the Lernen in your Lernen project:

• Step 1: Download the Package

  When downloading the zip package file from CodeCanyon, you'll have all the files you need inside. The zip package contains the following files:

  • Subscriptions.zip contains the LearnTier LMS - Subscription Addon for the Lernen
  • documentation.zip folder (It contains documentation for the add-on)

• Step 2: Extract the Package
  • Extract the downloaded zip file i.e. Subscriptions.zip
• Step 3: Install Subscriptions
  • Goto Admin > Manage Addons > Add new and click on Add/Update addon.
  • Choose the Subscriptions.zip file and click on Install.
• Troubleshooting

  If you encounter any issues while installing the LearnTier LMS add-on, follow these steps:

  • Ensure that the packages directory has write permissions
  • Ensure that the composer.json file has write permissions
• Alternatively, Manually Installation

  If you prefer to manually install the LearnTier LMS add-on, follow these steps:

  • Extract the downloaded zip file i.e. Subscriptions.zip
  • After uploading you need to execute the following commands in the website root directory through CLI
    • Execute this – php artisan module:enable Subscriptions
    • Execute this – php artisan module:migrate Subscriptions
    • Execute this – php artisan module:publish Subscriptions
    • Execute this – php artisan module:seeder Subscriptions

Add Subscription

The Manage Subscriptions > Subscriptions list > Add Subscription allows administrators to create and manage subscription plans for users on the platform. Here's a description of each field and feature:

• Role: Determines whether the subscription applies to students or tutors.
• Name: Text field for the subscription name (e.g., "Advanced," "Basic," or "Premium").
• Period: Dropdown to select the subscription duration (e.g., Monthly, Yearly, 6 Months).
• Price: Numeric field to set the cost of the subscription.
• Maximum sessions can buy: Numeric field to define the maximum number of sessions users can purchase under the subscription.
• Admin share (%): Percentage input to set the admin's share of revenue from the subscription plan.
• Revenue for sessions (%): Percentage input indicating the revenue allocated for session fees after deducting the admin's share.
• Auto Renew: Toggle switch to enable or disable automatic renewal of the subscription upon expiry.
• Upload subscription image: File uploader to add an image representing the subscription plan. Only accepts .png or .jpg files with a size limit of 3 MB.
• Description: Text area for providing a detailed description of the subscription.
• Click on Add Subscription to save the subscription and add it to the list of available plans.

Subscriptions List

The Manage Subscriptions > Subscriptions List section provides a centralized view of all available subscription plans. It allows administrators to manage and oversee the details of plans for both students and tutors.

• Dropdowns and search options at the top allow administrators to sort the list by role, status, or other criteria and search for specific plans.
• The View Button: (represented by an eye icon) displays detailed information about the subscription in a popup window.
• The Edit Button: (represented by a pencil icon) allows administrators to modify subscription details.

Purchased Subscriptions

The Manage Subscriptions > Purchased Subscriptions section provides a detailed list of all subscriptions purchased by users on the platform. This area is essential for managing and tracking the subscriptions, their statuses, and their usage.

Subscription Pages

When a Subscription is created, associated pages for Tutor Subscriptions and Student Subscriptions are automatically generated. These pages allow administrators to customized and managed through the Edit, Settings, View, and Delete actions available in the Manage Pages section.

• Edit (Pencil Icon) Manage technical and configuration settings of the subscription page.
• Settings (Gear Icon) Modify the content and layout of the selected subscription page.
• Opens the Page Builder where administrators can setting the page elements visually.
• Allows adding, editing, or removing Subscription banners, FAQs related to subscriptions, Steps for subscribing and Subscription details and descriptions elements.
• Supports drag-and-drop functionality for easy layout customization.
• Preview changes in real-time to ensure the design and content meet expectations.
• Changes can be saved and published directly.

• View (Eye Icon) Preview the subscription page in its current state.
• Delete (Trash Icon) Permanently remove the subscription page from the system.

Auto Renew Functionality

When a subscription is created with the Auto Renew Subscription on Expire option enabled, administrators can configure notification settings and manage what happens after the subscription expires. This ensures users can seamlessly renew their subscription using a dedicated link if needed.

Set Notify Subscription Expiry Before Days

• Navigate to Site Management > Global Settings > Lernen Settings.
• Locate the Notify subscription expiry before days field.
• Enter the number of days before the subscription expires when the user should receive a Email Notification.
• After the subscription expires, the Tutor or Student will not be able to purchase the subscription through the regular process. Instead, a Dedicated Renewal Link will be made available to them.

How to Add/Edit Email Content

The Email Settings section in the admin panel provides options to manage and customize email templates for various notifications and communications. Here is an overview of its features and functionality:

• Navigate to Site Management > Email Settings.
• Add New Template: Administrators can create new email templates by clicking on the Add new template button.

• Email Setting Variables Lists placeholders like {userName}, {subscriptionName}, and {renewalLink} that dynamically populate with specific data.
• Subject: Customize the subject line of the email.
• Greeting Text: Set the opening greeting (e.g., Dear {userName},).
• Email Content: Write or modify the body content, including dynamic placeholders for personalized messaging.
• Status: Enable or disable the email template using the toggle button.

Email notification is used to notify the user about the subscription expiry and renewal. This email notification looks like this.

Purchase a Tutor Subscription

After logging into the lernen, you can easily purchase a subscription tailored for tutors by following these steps:

• In the top-right corner of the dashboard, click on your profile icon and select Subscriptions.
• You will be directed to a page displaying the available subscription plans for tutors.
• Choose the plan that suits your needs (e.g., "Advanced" for 6 months at $799.99) and click the Buy Now button under the desired subscription.

• After clicking the Buy Now button, you will be redirected to the payment page where you can select your preferred payment method (e.g., PayPal, Stripe, or Credit Card).
• Enter your payment details and confirm the transaction.
• Click on Pay button to complete the purchase.

How to Allow a Subscription

After purchasing a subscription, you can allow it by following these steps:

• After login navigate to the Dashboard and select the Manage Bookings option from the sidebar.
• Under the Manage Bookings section, click on the Manage Sessions tab.
• In the Manage Sessions view, click the Add New Session button. A popup form will appear to input session details.
• In the popup form, locate the Allowed for Subscriptions toggle option.
• Enabled: The session will be available for students who have subscribed to the plan.
• Disabled: The session will not accept subscriptions and must be booked directly by the student.
• Click Save & Update to finalize the session.

Add New Slot

The Add New Slot feature allows tutors to create and manage time slots for their teaching sessions. This ensures that students can book sessions based on the tutor’s availability.

• Allowed for Subscriptions: A toggle option to enable or disable subscription usage for the slot.
• Enabled: The session will be available for students who have subscribed to the plan.
• Disabled: The session will not accept subscriptions and must be booked directly by the student.
• Click Save & Update to add the sessions to the calendar.

Edit Session

The Edit Session feature allows tutors to modify existing time slots for their teaching sessions. This ensures that students can book sessions based on the tutor’s availability.

• Click on the three dots ext to the session and select Edit option.
• The session editing interface will open.
• Allowed for Subscriptions: A toggle option to enable or disable subscription usage for the slot.
• Enabled: The session will be available for students who have subscribed to the plan.
• Disabled: The session will not accept subscriptions and must be booked directly by the student.
• Click Save & Update to save the changes.

Purchase a Student Subscription

After logging into the lernen, you can easily purchase a subscription tailored for students by following these steps:

• In the top-right corner of the dashboard, click on your profile icon and select Subscriptions.
• You will be directed to a page displaying the available subscription plans for students.
• Choose the plan that suits your needs (e.g., "Advanced" for 6 months at $799.99) and click the Buy Now button under the desired subscription.

• After clicking the Buy Now button, you will be redirected to the payment page where you can select your preferred payment method (e.g., PayPal, Stripe, or Credit Card).
• Enter your payment details and confirm the transaction.
• Click on Pay button to complete the purchase.

How to use purchased subscription

After purchasing a subscription, you can select it by following these steps:

• Once a subscription is selected, students navigate to the Find Tutors section to browse tutor profiles.
• Students can either view a tutor's profile or directly book a session.
• In the tutor's schedule, students select an available session and proceed to book it.
• If the selected session aligns with the student’s subscription plan, the process moves smoothly to the payment screen.
• If the tutor does not support the selected subscription plan, the system notifies the student during the checkout process.
• The message clearly informs the student that the selected subscription is not applicable to the cart item (specific subject or session). It advises the student to update their cart or choose a tutor who accepts the subscription.