Welcome ,
  1. Home
  2. Installing PageCarton Core to a Custom Directory

PageCarton Documentation

Interested in coding widgets, classes, or methods? Check out the Code section!

Installing PageCarton Core to a Custom Directory



Installing PageCarton by default has been made to be an easy process. Find the recommended installation instruction here "Installing PageCarton". First, this is to ensure the most secured options are set as preferred. It is best practice to ensure that system executable files are stored outside outside of the web root (e.g. htdocs, public_html, www, etc); so PageCarton by default installs all core files in a directory one step outside of the web root. It is recommended to always use the default installation settings unless you know what you are doing. It is however possible to choose a custom directory to install PageCarton in. More like, to change where PageCarton should look for files.

This is especially useful on servers where the webserver is not able to write into the directory outside the web root, in this case, you would have to install PageCarton into the web root itself. Meanwhile, this method can be used to make PageCarton core install to the web root. In this tutorial, that is exactly where we will be installing. Your own directory may be anywhere you choose, so far you have the right permissions set.

Download PageCarton Core

It is time to download the PageCarton Core files. The best place to get this is to download the ZIP archive from Github. This gets you all the core files without any other confusing files. You may also clone the git repository https://github.com/pagecarton/pagecarton to your computer.

Unpack the files and ensure you have a complete "core" directory that is inside the "pagecarton" directory. This is represented in the screenshot below.

Upload PageCarton Core to Server

Unzip the core files and transfer them to somewhere on the server. Note the directory where the "core" directory is located and copy them as follows:

  • Copy the whole "pagecarton" directory to wherever you would like it to be on the server. Just ensure you have all the correct permissions set so that the webserver user can read and write to the directory. In the example below, we will be installing directly inside the web root. See the screenshot below:
  • Copy all the contents of "local_html" directory to your web root. The "local_host" is located inside "core" directory.
  • Copy a file named "pc_installer.php" in "pagecarton/core/application/documents" directory to the web root, the same place where the contents of "local_html" was uploaded. This file needs to be there to make this look like a normal installation because without this, we may not be able to create the first admin user in during personalization.

Customize Configuration File

PageCarton could be hardly seen as a hard-coded system as most of the settings in it are configurable within the system itself. However, PageCarton has a configuration file which is only configurable in an external editor. The PageCarton configuration file is the JSON file that holds the hardcoded settings used in PageCarton. This is the only place where it is advisable to configure where the PageCarton is installed. The configuration file "pagecarton.json" is part of the files that was just copied from "local_html" directory to the web root. So look for "pagecarton.json" in the web root and open the file to edit its content.

Set the "PC_BASE" to the location of the directory where "core" is located. Do not use the "core" location directly, rather use the full path to the directory holding the "core" directory, which is "pagecarton" directory in most cases. Please note that this has to be a full path to the directory. Check the provided screenshots for example. Make sure the right permissions are set on the directory so that the web server can read and write to it.


PageCarton is now installed in a custom directory. You can check this by now trying to load your site from the browser. If you have any issues, try to start all over again or leave a comment on the forum so we can take a look. 



← Previous "Installing PageCarton via Composer""HTML Syntax & API for Embedding Widgets" Next →


Similar Documentation Article


Installing PageCarton via Composer Photo

Installing PageCarton via Composer

If you have Composer installed on your computer, you can easily get PageCarton up by running the following commands on your command line.  # download PageCarton via composer composer create-project pagecarton/pagecarton --prefer-dist -s dev # go into the project cd pagecarton # set up your web root cp -r pagecarton/core/local_html/* html # start your development server cd html && php -S localhost:8001 With this, you do not need to install any other server. Easy, ...



Setting up PageCarton via Docker Photo

Setting up PageCarton via Docker

PageCarton now has a few files in its GitHub repository that helps to set it up on Docker easily. If you are familiar with Docker or a newbie, you should be able to get started with PageCarton on Docker without stress.  The beauty of working with Docker is that you do not have to worry about setting up your server or configuring it. We have created a few settings in the Docker file to ensure the system will be using a compatible server to run your PageCarton in its container...



Steps in Creating a PageCarton Website Offline Photo

Steps in Creating a PageCarton Website Offline

Creating a website has now been made easy with the use of Pagecarton, it's not necessary to know much about coding. If you have your contents ready, and the style of how your website wants to look, your website creation with pagecarton is as easy as ABC.  For this tutorial, we will be using an offline server called LOCALHOST. After installing your favorite offline server, pagecarton will be needed to install on it so that we can access the pagecarton admin panel locally. If you do...



Steps in Creating a PageCarton Theme Photo

Steps in Creating a PageCarton Theme

Creating a PageCarton theme isn't actually a difficult task, but just that it might involve a long process and a little bit of how programming codes work. The main purpose of having a PageCarton theme is to ensure other users get an easy and fast customization of their own personal websites with the use of the themes(which serve as a template) created by other users. Getting an HTML Template File Download your desired already-designed template file. These kind of templates are most ...



HTML Syntax & API for Embedding Widgets Photo

HTML Syntax & API for Embedding Widgets

In an update to PageCarton that was available from August 2020, we added a new way to create and customize PageCarton Themes. In addition to existing ways of creating and customizing themes, you can now customize themes completely from the raw HTML code section using your favorite code editor. Before now, most of the theme layout design functions has been limited to the visual Page Editor in the PageCarton Admin Panel, we noticed that this has proved to be dif...



PageCarton Admin Panel Photo

PageCarton Admin Panel

The PageCarton Admin Panel is the default control center of PageCarton. While PageCarton is built with privileges from ground up, which allows to customization even from the frontend, the Admin Panel now serves as the control center where all the administative functions can be found in one place. The Admin Panel is a component of PageCarton system that provides the ability to view and change application settings. It consists of a set of widgets that include adding or removing fun...