Documentation for Prowriters


Installation


Before installing the application make sure that your server meets all the requirements

Video Tutorial

Follow the instructions in video if you do not have option to change the document root on your server

Using Installation Wizard

1. Setup Database
  • Login to your hosting cPanel and navigate to MySQL Databases
  • Create database.
  • Create a user and set up password for the user
  • Give the user permission to execute the database queries
  • Make sure you have checked All privileges  when assigning the permissions.
2. Upload files and setup Document Root
  • Upload the files to your server in your desired location. Let's say you put it inside public_html
  • Now go to domain management option and make sure your domain's document root is the public folder of the application. So the document root path should read public_html/public just like in the screenshot below.
  • Now from your browser go to http://yourdomain.com/install
*** Follow the steps below if you do not have option to change the document root on your server

Let's assume your document root path is home/public_html. Which means when you hit your domain url in the browser the server executes an index.php file residing inside it.

  1. Create a folder called prowriters inside /home
  2. Upload the "Prowriter.zip" file to "prowriters" directory on your server, and unzip the file
  3. Find a folder called "public". Copy all the files and folders inside it and move them to home/public_html directory
  4. Now delete the public folder that is inside prowriters directory. (If you have moved the files and folders correctly as mentioned earlier, the "public" folder inside the "prowriters" directory should be empty by now.)
  5. Now go to home/public_html directory and open the file called "index.php"
  6. Now find the following line:
  7. require __DIR__.'/../vendor/autoload.php';
    and replace it with the following line
    require __DIR__.'/../prowriters/vendor/autoload.php';
  8. Now find the following line:
  9. $app = require_once __DIR__.'/../bootstrap/app.php';
    and replace it with the following line
    $app = require_once __DIR__.'/../prowriters/bootstrap/app.php';
That's it. You are now ready to procceed the next step.
3. Installation

By this time you should be able to see the installation page

  • The first page of the installation process checks and shows if your server meets the requirements of the application to run. Click Next if everything is alright. However, if any required php extension or folder permission is missing you have to take steps accordingly. If you do not have access rights to the system you might need to contact your hosting provider solve it for you.
  • Enter your database access information, Check if the base URL is correct and click on Connect Database
  • Now click Install
  • If the installation is successful you will see a message and a login button. Click the button to go to the login page. Use the following credentials to access the software.
  • Email Password
    admin@demo.com 123456
  • In case the installation was not successful, it will provide a link to a file for you to download which will contain information about what went wrong. Open the file and see if it’s something that you can resolve, if not then please contact us with the file.

Using Artisan Command (For developers)

Create a database first. Then upload the files to your server and enter the database information in the .env file that comes with the application( You will find it in the root directory of the application). In case you cannot see the env file, please turn on "View hidden files" from your cpanel settings option. Now run the following artisan commands:

php artisan migrate
php artisan db:seed
php artisan db:seed --class=UsersTableSeeder
php artisan key:generate
php artisan storage:link

Make sure your domain's document root is the public folder of the application. Now go to yourdomain.com/login and use the following credentials to login.

Email Password
admin@demo.com 123456

If you need to have dummy content for testing the application, run the following artisan command

php artisan prowriters:dummy-data