Manually Installing Orchard Modules and Themes from Orchard Gallery

Manually Installing Orchard Modules and Themes from Orchard Gallery

Late Thanksgiving evening I was developing an Orchard Website when I noticed the Orchard Gallery Package Feed from within the Orchard Dashboard was not working. I kept getting HTTP 404 Not Found errors when attempting to download any custom modules and themes from the Orchard Gallery. I didn't have time to post a question in the Orchard Discussion Forums and wait for an answer to this problem. I had a deadline and this deadline was not going to wait for an answer over the holidays. Therefore, I did what any resourceful Orchard Web Developer would do, I downloaded and installed the custom Orchard Modules and Themes manually. Here is how you do it!

The Dreaded Orchard Gallery Feed Service Error

First things first. The Orchard Gallery was recently moved to Azure and the feed service was not working. Here is the dreaded 404 Error I received when trying to download Orchard Modules and Themes.

Orchard Gallery Download Orchard CMS Modules and Themes

When this happens you can always download the Orchard Modules and Themes manually, unzip them, and install them in the modules or themes directories. In fact, if you have them already installed in another project and you know they are up-to-date, you can just copy them from one project to another. Let's manually download them, however, because they don't come down as Zip Files, but Nuget Packages. This might throw you off if you haven't seen a Nuget Package before.

Download Orchard Module from Orchard Gallery

So let's say the Orchard Gallery Packages Feed is down and you really need to have the Orchard Code Generation Module installed in the Orchard Website. You could just copy it from one project to another, or you could swing on over to the Orchard Gallery and click the download button to download the module.

Download Custom Orchard Module and Orchard Theme from Orchard Gallery

When you click the download button and view the file you will notice it has the extension nupkg, which is a Nuget Package.

Orchard.Module.Orchard.CodeGeneration-1.3.0.nupkg

This is a Zip File in disquise! Just change the extension from nupkg to zip.

Orchard.Module.Orchard.CodeGeneration-1.3.0.zip

Now that you have changed the extension you can view and extract the Zip File!

Manually Installing the Orchard Module

Once you have extracted the contents of the Zip File you will notice an Orchard.CodeGeneration Folder within the Content/Modules Directory. This is the directory that must be copied and placed into the Modules Directory of your Orchard Website.

Orchard Modules and Themes are Nuget Packages

Copy that Orchard.CodeGeneration Folder and toss it into the Modules Directory of your Orchard Website with all the other Orchard modules.

Manually Install Custom Orchard Module in Orchard Website

Continue the same process for all the Orchard Themes and Modules you want in the website. Again, if you have these modules installed for other Orchard Websites on your development PC, you can save yourself a lot of work with just a bit of copy and paste from one website to another.

Fixing the Orchard Gallery Feed

Obviously this manual download and copy and paste stinks and it should only be done in an emergency like mine or if you just want to download the modules and themes manually to learn from them. Apparently the old Orchard Gallery Package Feed URL was supposed to correctly work and redirect, but it is not for some reason. In the interim until this is resolved ( or maybe it is resolved by the time you read this ) you can change the Orchard Gallery Package Service Feed to the one in the image below and it will work.

New Orchard Gallery Feed Service

If you want a more up-to-date status on this problem, I would consult the Orchard Discussion Forums. It may no longer even be a problem by the time you read this blog post.

Update 3/25/2012: This appears to be a problem even in Orchard 1.4. Here is a better walkthrough of fixing this problem: Fixing the Orchard Gallery Feed Error - Install Package Failed.

Conclusion

Hopefully you found this Orchard Tutorial useful. Even if you are not having problems with the Orchard Gallery Package Feed Service, it is important to understand how to manually download and install Orchard Modules and Themes into your Orchard Websites.