For the installation I followed the official procedure found at https://pyrocms.com/docs/pyrocms/setup/installation#installing-pyrocms.
Note: I'm installing PyroCMS v3.0 beta2 on my Lenovo Thinkpad hosting Ubuntu 14.04 with PHP 5.5.9.
The installation procedure requires Composer
to be installed on your system. I already had it available on my system, but it can easily be installed following this Composer installation manual
During PyroCMS v3.0 installation you will be prompted to enter your GitHub OAuth credentials. Simply open the hyperlink in a Browser window and logon to GitHub. Create a GitHub account if you don't have one already. Copy/paste the GitHub OAuth Authentication Token in the installer window and press Enter. Composer will save your OAuth credential in the ~/.composer/auth.json
file and can now proceed and download all dependencies from the different GitHub repositories.
Running the PyroCMS installer
Before running the PyroCMS installer make sure you have properly configured your Webserver and have set the proper rights. Because PyroCMS v3.0 is based on Laravel
, make sure that you point your docroot to the pyrocms/public
When the installation finished you will be prompted to remove the installer module.
You can remove this module by removing the folder core/anomaly/installer-module.
Your first 404
If you visit the site for the first time after installation you will hit a 404 page.
Prior versions of PyroCMS hosted some default content after installation, but starting from v3.0 it seems that there are NO pages and/or Page Types defined by default! To resolve your 404 issue you first need to create: fields, Page Type and home page.
Step one: create custom fields
First we need to add some custom fields to PyroCMS.
Create a new custom field of type WYSIWYG and name it 'Content
Step two: create page type
Second step is to create a new Page Type (eg. "Default").
Assign some of the custom fields to it by clicking the Fields
Don't forget to edit the Layout (Layout tab) of the Page type and add the fields you want to add to the output. Note that I used the '|raw
' syntax, because otherwise it would print the HTML code (<p></p>). Take a look at the Field Type documentation
for more information about the possible options.
Step three: create Home page
Now that we have created our first page type we can proceed with the final step.
Create a new page and select the newly created Page Type "Default"
Enter values for all relevant fields. In the Options
Tab make sure you Enable
the page and you mark it as the Home
By this time your site will have a default landing page showing a title and some content.
In this article I showed you how to install PyroCMS v3.0 Beta2 and some very basic steps to setup and publish your first page. I hope I find the time to explore PyroCMS v3.0 in more detail, especially around custom development and using the Laravel API's. I'll post my findings in another article when appropriate. Cheers!