Welcome to Shaun Luttin's public notebook. It contains rough, practical notes. The guiding idea is that, despite what marketing tells us, there are no experts at anything. Sharing our half-baked ideas helps everyone. We're all just muddling thru. Find out more about our work at bigfont.ca.

Some Common Orchard CMS / Visual Studio Fixes

Tags: orchard-cms

Tuesday, June 24, 2014 6:11:18 PM

Orchard Doesn’t Build

  1. Ensure all projects target compatible frameworks. For instance, in Orchard 1.8, make sure all projects target .NET Framework 4.5 in Properties > Application.
  2. Rebuild the entire solution. This is a nuclear option; that said, it sometimes works.
  3. Ensure references are correct. In particular, check these usual suspects:
    1. Orchard.Core
    2. Orchard.Framework
    3. System.Web.WebPages (correct version?)
    4. We can often find these here: \Orchard.Source.1.8\src\Orchard.Web\Core\bin

Orchard Doesn’t Render (e.g. White Screen or Server Error)

  1. View the log file. This is in AppData/Logs/orchard-error-YYYY.MM.DD.log
  2. Delete the AppData/Dependencies folder. This will refresh any dependencies that might be out of date.
  3. Check folders’ access control. In particular grant Modify and Read privileges to IISIUSRS for the AppData, Modules, Themes, Media folders.
  4. Properly configure the IIS App Pool. This applies if your using IIS.
    1. .NET CLR Version > Match your Applications .NET Framework
    2. Enable 32-bit Applications > True
    3. Managed Pipeline Mode > Integrated

Orchard Doesn’t Serve/Find a Particular File

  1. Ensure resource’s folder has the appropriate web.config file. This applies to Views/Styles/Images/Content folders, for instance.

Visual Studio Weirdness

  1. Close and reopen Visual Studio. This fixes all sorts of problems.
  2. Delete the suo file. This is the Solution User Options file. http://msdn.microsoft.com/en-us/library/bb165909.aspx
  3. Project build succeeds with an error list OR Intellisense is missing. Close Visual Studio, delete the suo file, open Visual Studio. See also:
    1. http://stackoverflow.com/questions/13375961/visual-studio-2012-intellisense-sometimes-disappearing-broken
    2. http://stackoverflow.com/questions/17703004/visual-studio-displaying-errors-even-if-projects-build

Other

  • Orchard doesn’t serve my CSS or JavaScript (or other linked resource). Make sure there is an appropriate web.config file in your Styles or Scripts folder.