Welcome Requirements Step 1: Download and Upload Files Step 2: Create a Database Step 3: Run the Installer Step 4: Complete Installation PayPal Integration reCAPTCHA Integration SMTP Settings Customize Your Site Updating Page Content Cron Job Instructions Important Security Step Troubleshooting

YouPro - Media Script With Points System - Setup Installation Guide

Welcome to YouPro - Media Script With Points System

This guide will walk you through the setup and installation of your YouPro - Media Script With Points System Script. Follow each step to ensure a smooth installation process.

Requirements
  • PHP Version: 7.4 or higher
  • MySQL Database: 5.6 or higher
  • cURL Extension: Enabled
  • File Permissions: Ensure the uploads directory is writable.

Note: The config.php file is automatically generated during the installation process. You do not need to manually edit or set permissions for this file.

Step 1: Download and Upload Files

First, download the script package from Codester. Follow these steps to access and download your files:

  1. Log in to your Codester account.
  2. Go to the Downloads section from your profile menu.
  3. Locate the YouPro - Media Script With Points System in your purchased items list and click the Download button.
  4. Select All files & documentation to download the complete package, which includes the script files, documentation, and license information.

After downloading the package, extract the files on your computer. Then, upload all files to your web server using an FTP client or the file manager in your hosting control panel.

Step 2: Create a Database

In this step, you will create a MySQL database and a user. Follow the detailed instructions below. This guide covers both cPanel and phpMyAdmin methods. Choose the method based on what your hosting provider offers.

Option 1: Using cPanel (Recommended for Beginners)
  1. Log in to your cPanel account (provided by your hosting service).
  2. Go to the MySQL Databases section under the Databases tab.
  3. Under the Create New Database section, enter a name for your database (e.g., youpro_db), and click Create Database.
  4. Scroll down to the MySQL Users section. Enter a username (e.g., youpro_user) and a strong password, then click Create User.
  5. After creating the user, go to the Add User to Database section. Select the user and the database you created, and click Add.
  6. When prompted, select All Privileges to grant full permissions to the user, and click Make Changes.

Keep the following details ready for the installation process:

  • Database Name (e.g., youpro_db)
  • Database Username (e.g., youpro_user)
  • Database Password (the password you created)
Option 2: Using phpMyAdmin
  1. Log in to your phpMyAdmin panel. You can usually access it from your hosting control panel (cPanel or Plesk) or directly via a link like http://yourdomain.com/phpmyadmin.
  2. Click on the Databases tab at the top of the page.
  3. In the Create database section, enter a name for your database (e.g., youpro_db), and click Create.
  4. Next, click on the Users tab (or go to the Privileges section).
  5. Click on Add User. Enter a username (e.g., youpro_user) and a strong password.
  6. Under Global Privileges, select Check All to grant full permissions to the user, then click Go to save the changes.

Make sure to note down the following details:

  • Database Name (e.g., youpro_db)
  • Database Username (e.g., youpro_user)
  • Database Password (the password you created)
Troubleshooting Tips:
  • If you get a "Connection error," ensure that the database name, username, and password are entered correctly during installation.
  • Verify that the user has full privileges for the database.
  • If you're using a remote server, check if the database host is set to localhost or the specific server IP address provided by your host.

Once you have created the database and user, proceed to the next step of the installation process.

Step 3: Upload Files and Run the Installer

Before starting the installation process, make sure you have uploaded all files from the upload.zip archive to your web server. You can do this using an FTP client or the file manager in your hosting control panel. The contents of upload.zip should be placed directly into the root directory (e.g., public_html or htdocs).

Once all files are uploaded, navigate to the installer by accessing your domain in the following format:

http://yourdomain.com/install.php

You will see the installation form where you need to enter your database and site information. Fill in the required details as described below:

Form Fields:
  • Database Host: Usually "localhost"
  • Database Name: The name of the database you created
  • Database Username: The database user with privileges
  • Database Password: The password for the database user
  • Admin Username, Password, and Email: Credentials for the admin panel
  • Site Name: Your website's name
Important Note:
  • Ensure that you have uploaded the entire content of the upload.zip file before starting the installation.
  • Do not rename or move any files after uploading, as it may cause issues during installation.
Step 4: Complete the Installation

Click "Start Installation" after filling out the form. If the details are correct, the script will automatically create the necessary database tables and configuration file.

Once the installation is complete, you will see a success message with a link to the admin panel:

http://yourdomain.com/admin/login.php
Final Steps:
  • Log in to the admin panel using the credentials you set during the installation.
  • For security reasons, delete the install.php file from your server.
PayPal Integration

To enable PayPal payments, you will need a PayPal Client ID. After logging into the admin panel, go to the Settings page and enter your PayPal information under the PayPal Settings section.

Follow these steps to get your PayPal Client ID:

  1. Log in to your PayPal Developer account at https://developer.paypal.com.
  2. Go to My Apps & Credentials in the dashboard.
  3. Create a new app and choose the Sandbox environment for testing.
  4. Copy the Client ID from your app details and paste it into the PayPal Client ID field in the admin settings.

After testing, follow these steps to switch from sandbox to live mode:

  • In PayPal Developer, go to My Apps & Credentials.
  • Select Live instead of Sandbox.
  • Copy the Live Client ID and update it in the PayPal Settings section in the admin panel.
reCAPTCHA Integration

To secure your forms using Google reCAPTCHA, you will need a Site Key and Secret Key. After logging into the admin panel, go to the Settings page and enter your reCAPTCHA information under the ReCAPTCHA Settings section.

Follow these steps to get your reCAPTCHA keys:

  1. Log in to your Google reCAPTCHA account at https://www.google.com/recaptcha/admin.
  2. Click on + Create to add a new site.
  3. Select reCAPTCHA v3 for score-based verification.
  4. Enter the label for your site and the domain (e.g., demo.youproscript.com).
  5. Agree to the reCAPTCHA terms of service and click Submit.
  6. Copy the Site Key and Secret Key generated by Google and paste them into the respective fields in the admin settings.

Once you have entered these keys, reCAPTCHA v3 will be enabled for score-based verification on your forms.

SMTP Settings

To enable email notifications and other email-based functionalities, you will need to configure your SMTP settings. After logging into the admin panel, go to the Settings page and enter your SMTP information under the SMTP Settings section.

Here’s an explanation of each SMTP setting required:

  • SMTP Host: The SMTP server address, provided by your email service provider (e.g., smtp.gmail.com).
  • SMTP User: Your email account username or the full email address used to authenticate with the SMTP server.
  • SMTP Password: The password for your email account or app-specific password if using a provider like Gmail.
  • SMTP Port: The port number used for SMTP, usually 587 for TLS or 465 for SSL.
  • SMTP Security: Choose between TLS or SSL based on your email provider’s requirements.
  • Sender Name: The name displayed as the sender in outgoing emails.
  • Sender Email: The email address displayed as the sender in outgoing emails.

Enter this information carefully, as incorrect SMTP settings will prevent email notifications from being sent. If unsure, please contact your email service provider for the correct SMTP settings.

Customize Your Site

To personalize your site with a custom name, description, favicon, and logo, navigate to the Customize page in the admin panel under the Admin Customize section. Here’s how to update each of these settings:

  • Site Name: Enter the name you want displayed as the title of your website. This name will appear in browser tabs and search engine results.
  • Site Description: Provide a brief description of your site’s purpose. This description helps with SEO and will appear in search results.
  • Favicon:
    1. Click Upload Favicon to select an image file from your computer.
    2. Choose a square image in PNG format (recommended size: 32x32 pixels) for best results.
    3. After uploading, the favicon will be displayed as the browser icon for your website.
  • Logo:
    1. Click Upload Logo to choose a logo image from your computer.
    2. The logo should be in PNG format with a transparent background, ideally sized to fit your website design.
    3. The uploaded logo will appear at the top of each page, replacing any default placeholder logo.

After making changes, make sure to save them by clicking the Update button at the bottom of the Customize page. Your site name, description, favicon, and logo will then be updated across the website.

Updating Page Content

Your website includes important pages like Privacy, Terms, and About Us. You can customize the content of these pages directly from the admin panel under the Pages section.

To update each page:

  • Log into the admin panel and navigate to Pages in the menu.
  • Select the page you want to update, such as Privacy, Terms, or About Us.
  • Edit the content as desired using the text editor provided.
  • Click Update to apply the changes.
Cron Job Instructions

To automate the process of distributing rewards to leaders based on the leaderboard, you need to set up a cron job on your server. Follow these instructions to set it up correctly:

Step 1: Locate the Cron Script

The cron script file is located in the root directory of your project:

award_leaders.php
Step 2: Set Up the Cron Job

Use the following command to set up a cron job that runs the script every day at midnight (00:00):

0 0 * * * /usr/bin/php /path/to/your/project/award_leaders.php >/dev/null 2>&1
  • 0 0 * * *: Runs the cron job at midnight every day.
  • /usr/bin/php: Path to the PHP executable on your server.
  • /path/to/your/project/award_leaders.php: Full path to the cron script.
  • >/dev/null 2>&1: Suppresses output to prevent email notifications.
Step 3: Verify the Cron Job

After setting up the cron job, verify it using the following command:

crontab -l

This will display all active cron jobs for your user.

Note:
  • Ensure the script has executable permissions:
    • chmod +x award_leaders.php
  • Set the correct time zone on your server to ensure the cron job runs at the intended time.
  • Avoid setting up multiple cron jobs for the same script to prevent duplicate processing.
Important Security Step

For security reasons, please delete the install.php file from your server after installation.

Troubleshooting

If you encounter any errors, please check the following:

  • Database credentials are correct.
  • Required PHP extensions (e.g., cURL) are enabled.
  • File permissions allow the script to create files in your server directory.

If issues persist, please contact our support team at [email protected] with details of the error message.

Thank you for choosing YouPro Script! Enjoy your new website!