23

Jan

Installing PyroCMS v3.0 Beta2

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.

Installation

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 folder!

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 button.


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 page.



By this time your site will have a default landing page showing a title and some content.

Conclusion

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!