Installation

The usage of Stack will allow you to add basic pages for your TCG such as information about your TCG and such through the admin panel—pretty much a content management system like WordPress! However, there are some complex PHP scripts that aren’t allowed to be fully hosted via the database, hence, Stack comes with a list of snippets or plugins that you can add on your page, which will then be explained further.

1. Just like any other scripts, I will do my best to fully explain these documentations as neatly and as concise as possible for both installing and using Stack for your TCGs. Please do keep in mind that Stack is different from other scripts there is, so make sure to read the entirety of this documentation.
2. Once Stack has been installed and you're logged in on the admin panel, kindly read through whatever instructions there is on the documentations before you change anything. Although most of the input fields have their specific guidelines, they are brief and only stands as a reminder/notice. If you think a certain part of the script should be explained more, please feel free to suggest it to me through our community forum.
3. Before converting TCGs that uses MyTCG or any other script to Stack, backup your databases first! You can do this by using phpMyAdmin or similar from your host and then Export the tables you have for your TCG. If you don't have access to your database, you will have to contact your host.

If this is your first time installing Stack CMS, carefully follow these step-by-step instructions.

• Create a database first to use for Stack. You can do this via your server's control panel under the MySQL Databases option. If you don't have any control panel access, contact your host to make the database for you. Make sure to remember your database credentials since you will be needing them later on.
• Download the latest version of Stack from the website. Unzip or extract the file/archive to a temporary location on your hard drive. The unzipped archive must have the following structure:

• Go to the /admin folder and then open the class.lib.php file. Change the variables to match your database settings. If you don't know what the values of the database variables are, ask your host for these. Below are the following explanation about these variables:
  
  

  $db_server = 'localhost';        // The database server, usually localhost
  $db_user = 'myUsername';         // The username for your database
  $db_password = 'myPassword';     // The password for your database
  $db_database = 'stack_db';       // The name of your database

  Please do keep in mind that your host/account's database server is usually localhost by default. However, some hosting providers have different database servers, like DreamHost—which is dependent on your host's domain (e.g. mysql.domain.tld). So, if localhost doesn't work for you and the script tells you that it can't connect to the server, ask your host for the correct database server.

• Copy all the files and folders of the unzipped archive into your website's root path where you want to run your TCG. Kindly take note that Stack's admin panel is located at the /admin folder, so all the PHP files outside this folder is what will be displayed on your main TCG's site.
• Once done, direct your browser to run the /install folder and then follow the 2-step installation to setup your TCG. The supposed URL to run the install should be:
  
  

  http://yourdomain.com/install/          <- If you have your TCG on a domain
  http://tcg.yourdomain.com/install/      <- If you have your TCG on a subdomain

• If your installation is successful and all of the required tables (48 tables in total from the database) has been created—which must have a as a success indicator, click the Delete button to delete the /install folder and its files.
• At this point, your installation should be complete and you should be able to login to your account. Go to Stack's admin panel and configure the rest of your TCG's settings first (configuration, card categories, card sets, user levels and such) before adding cards and other stuff.

If you have Stack CMS currently installed and you wish to upgrade it to a newer version, carefully follow these step-by-step instructions.

• Make sure to back up your current Stack CMS database first. You can do this by using phpMyAdmin or similar from your host and then Export the tables you have for your TCG. If you don't have access to your database, you will have to contact your host.
• Download the latest version of Stack from the website. Unzip or extract the file/archive to a temporary location on your hard drive. Please take note that an upgrade archive only includes the files that has been updated and/or modified from the previous version.
• Copy all the files and folders of the unzipped archive into its rightful folders. This should overwrite the old files that needs to be upgraded.
• Once done, direct your browser to run the /upgrade folder and then click the Upgrade to 1.x.x button. The supposed URL to run the upgrade should be:
  
  

  http://yourdomain.com/upgrade/          <- If you have your TCG on a domain
  http://tcg.yourdomain.com/upgrade/      <- If you have your TCG on a subdomain

  If your upgrade is successful, it should show a prompt message and the list of upgraded sections with a as a success indicator. Then click the Delete button to delete the /upgrade folder and its files for security purposes.