Wednesday, November 23, 2011

Installing Orchard Themes

Go to http://OrchardProject.net.
Click on Gallery.
Click on Themes.

Browse through and select one you want to try out.

Click the Download button.
It will immediately try to save Orchard.Theme.XXXXXX.nupkg. Save that to your system.

Go to your site and login as an administrator.
From your dashboard, choose Themes

Click on install a theme from your computer
It asks for a location.
Browse to the Orchard.Theme.XXXXXXX.nupkg file.
Choose Open
Choose Install

Enable your new theme
You should now see it in your Orchard dashboard in the themes section.
Hit the Enable link below it.

Now you can choose it as the current theme. When you do, it is live immediately.

It is now ready for you to switch themes.

Installing Orchard on DatabaseMart.com

This was not a straightforward process.

Create the site on Helms.
Go to your Parallels Helms control panel, usually http://cp.YourSite.com.
Log in.
Domains - Create Site

Create the database on Helms.
Under your domain, go MS Sql Databases - Create.
Set a user account and a password.
Grab the connection string from here.

Make sure it is ready by navigating to http://YourSite.com.

Download and install Orchard on your local machine.
I couldn't get that to work through WebMatrix, so I downloaded and copied the source code to my local machine under My Documents\Visual Studio\Projects\Orchard. Then I opened the whole thing in Visual Studio through the Orchard.sln file.

Try to run it. Just hit F5.
It will ask for a connection string. Use the one from above when you created your database.
Understand that although your site is running locally, it is using the live database from when you'll be live later. You won't need to make any config changes after install.

Choose Build-Publish website.
Enter your FTP account information.
Important: Upload the site to ftp://ftp.YourSite.com under the wwwroot directory.

Try to run it by navigating to http://www.YourSite.com.
It should work just fine now.

Troubleshooting:
Directory Listing Denied
Make sure that extentionless URLs are allowed by asking the site admin it switch you to ASP.NET 4.0. It allows extensionless URLs by default.
If that doesn't do it, you'll allow them by editing web.config.
Also, be careful. This error will occur if you install to the root directory instead of to wwwroot.

Permissions; Can't
Change the app pool from a shared app pool to an isolated app pool.
If that doesn't work, you can try changing the permissions to 777 in all directories under App_Data. But the app pool fix will usually work. Try that first.

Server Unavailable
Change the app pool from a shared app pool to an isolated app pool.