Mark Graber's Posts

Sample Code

Fri, 28 Oct 2011 16:13:00 -0400

Today, I just wanted to share a few lines of code that have been useful in many situations. This introduces a few of the built-in Sitecore utility methods.

Here is the sample code:

if (Sitecore.Data.ID.IsID(itemId)) {
	Item item = Sitecore.Context.Database.GetItem(Sitecore.Data.ID.Parse(itemId));
	strPageTitle = Sitecore.StringUtil.RemoveLineFeeds(item.Fields["Page Title"].Value);
}

Let's break it down:

Sitecore.Data.ID.IsID()
This method takes in a string guid and returns true if it's a valid guid in Sitecore
Sitecore.Data.ID.Parse()
This method takes in a string guid and returns a Sitecore ID object
Sitecore.Context.Database.GetItem()
This method takes in a Sitecore ID object and returns a Sitecore Item object
Sitecore.StringUtil.RemoveLineFeeds()
This method takes in a string and returns the same string with line breaks removed. This is helpful if you are populating an HTML tag attribute or a line of JavaScript where line breaks would be invalid.

Lucene Field Type Configuration

Fri, 14 Oct 2011 07:46:00 -0400

This topic is related to using Lucene with the Sitecore shared source module Advanced Database Crawler from Alex Shyba, http://sitecoreblog.alexshyba.com/2010/11/sitecore-searcher-and-advanced-database.html. My searches were not returning the expected results consistently when using the FieldValueSearchParam. The search worked on some fields, but not others. The FieldValueSearchParam allows you pass in a collection of fieldName, fieldValue pairs to search for values in specific fields. This is a very powerful tool because it executes much faster than Sitecore queries. After a number of test cases, I noticed that the fields there were not working were of field type, Droplist and AccountSelector. Droplist is a built-in Sitecore field type that allows you to see a dropdown of values to select from, but it stores the raw value as plain text rather than a Guid like the Droplink field type. The AccountSelector is a Sitecore shared source module that lets you select a user or multiple users from the Sitecore security database. It stores the logins as plain text '|' delimited for multiple logins. Since both were essentially single-line text values, the configuration you need to add is the same as the single-line text field type. Add the following to your search config file and rebuilt the index.

Without these settings you can search for the items with the Full Text query, but not the Field search because the text from the Droplist and AccountSelector fields are added to the full text but not stored as the field level without this config change.

Sitecore API Docs

Wed, 05 Oct 2011 14:41:00 -0400

Here are two links to Sitecore API docs. I'm not sure what the version number represents, but I'm developing on Sitecore 6.0 through 6.5 and haven't found a class or method that is not listed.

http://sdn.sitecore.net/doc/api%205.0/Sitecore.html

http://sdn.sitecore.net/doc/api%205.1.1/Sitecore.html

Sitecore Utilities

Wed, 14 Sep 2011 14:22:00 -0400

Here are some helpful methods in some of Sitecore's built-in utility classes. There are many helpful utilities burried in the Sitecore API, but these are a few to explore.

Browser Detection

Sitecore.UIUtil.IsFirefox()
Sitecore.UIUtil.IsIE(6)

String Utility

Sitecore.StringUtil.ExtractParameter()
Sitecore.StringUtil.ArrayToString()

File Utility

Sitecore.IO.FileUtil.ZipFiles()

Getting Guid from Sitecore

Sitecore.ItemIDs.RootID
Sitecore.ItemIDs.AnonymousUser
Sitecore.ItemIDs.EveryoneRoleID

Subversion to FTP Site Release Process

Fri, 24 Jun 2011 16:57:00 -0400

Subversion is our preferred tool for managing our source code revisions and merging code between development teams. This article describes a way to leverage your Subversion revisions to release files to a hosting environment that may not allow you to run an update via SVN, but instead your only access point is through FTP site.

Managing CSS Files in Sitecore

Sun, 22 May 2011 13:41:00 -0400

Sitecore is a content management system, but can it also be a web design management system? The short answer is that you can design some solutions to provide flexibility for content management users to manipulate the the design via CSS files, allow them to manage and upload their own CSS files or make changes to the initial CSS files.

Read more for the configuration steps required to support CSS files as Sitecore Media Assets.

Changes to FieldRenderer When Upgrading from Sitecore 6.2 to 6.3

Wed, 27 Apr 2011 14:47:00 -0400

In addition to the following references to review and consider when upgrading from Sitecore 6.2 to 6.3, you should be aware of a small change to the FieldRenderer control. Sitecore 6.3 removes new-line (\n) characters from Multi-Line Text fields so if your code is setup to use those new-line characters and replace them with <br /> tags or split on them to build an array of lines, you should get the raw value from the Value property on the Field collection instead of getting it from a FieldRenderer because the Value property will still include the new-line character.

Sitecore 6.3 Release Notes

http://sdn.sitecore.net/SDN5/Products/Sitecore%20V5/Sitecore%20CMS%206/ReleaseNotes/ChangeLog/Release%20History%20SC63.aspx#631initial

Introducing Sitecore 6.3 PDF Reference

http://sdn.sitecore.net/Reference/Sitecore%206/Introducing%20SC63.aspx

Helpful Admin Pages to Secure in Production Environments

Fri, 22 Apr 2011 12:20:00 -0400

The following URLs are very helpful admin pages, and they are not secured with password protection by default. You should secure these in production environments. I recommend securing your whole sitecore folder with IP restrictions in IIS because this is very quick and easy to setup.

/sitecore/admin/cache.aspx - lets you monitor the caches, sizes, and clear cache
/sitecore/admin/stats.aspx - lets you see the Sublayout Html caches to confirm if you Sublayout caching is working as expected
/sitecore/admin/showconfig.aspx - lets you see the working Sitecore config settings in case your not sure if there is a patch config in your App_Config/Include folder is overriding something in the Web.config file

Subversion Tip - Simple Rollback to Previous Version

Sat, 29 Jan 2011 14:09:00 -0500

Although this is not specifically a Sitecore topic, it is something that comes up often for us on our Sitecore projects because we almost always use Subversion to manage our code and configuration files. In the case where you've made an update that you want to revert back and have it become the latest revision again, take the following steps:

First, make sure the file you want to rollback is identical to the latest version checked in, and you can do this by running an Update on the file. Then, right-click the file and select Diff. It should return the identical message. If not, you can deleted the file and get the latest.
Now that you have the latest version of the file, right-click on the file you want to rollback and select TortoiseSVN>Show Log
Right-click on the file in the bottom half of the window where it shows Action, Path, Copy from path, and Revision. Select "Revert changes from this revision"
It will prompt you with a message about reverse-merging the revision into your working copy. Click Yes to the prompt.
To confirm it matches the previous version, right-click on the file and select Diff with previous version. You should get a prompt that the files are identical.

Using Akamai Net Storage for Sitecore Media Items

Sun, 23 Jan 2011 09:45:00 -0500

This article provides some ideas on how to leverage an externally hosted Media Library, such as, Akamai NetStorage. Click to view the full post.

Include config files

Wed, 19 Jan 2011 15:35:00 -0500

As Sitecore continues to move components out of the 2000+ line Web.config file, don't forget to sift through the config files in the App_Config/Include folder. An example of this came up for me today with the Sitecore Ecommerce Module where a config file in the Include folder was overriding the Web.config setting.

Some of the important things to remember about these config files is that they can override settings that are in the Web.config file. Here is the simple example from the Ecommerce Module.

Sitecore Announces Better Shared Source Support

Fri, 14 Jan 2011 10:39:00 -0500

Here is a trackback to Jimmie Overby and the Sitecore Shared Source Blog. The Shared Source Blog is a great way to read about new things happening with the shared source modules. The shared source modules are great, and now even better with "Tested by Sitecore" assurance. Here is a link to the full post:

http://sharesitecore.wordpress.com/2011/01/14/announcing-the-better-shared-source-initiative/

Linking to Content Editor

Wed, 15 Dec 2010 12:33:00 -0500

Here is an easy way to link to the Sitecore Content Editor for your Custom Applications within the Sitecore Desktop. I also recommend that you set the target of the link to _blank or a named target so that it opens in another window.

protected string GetInternalItemLink(string guid, string lang) {
    return string.Format("/sitecore/shell/sitecore/content/Applications/Content Editor.aspx?id={0}&la={1}&fo={0}", guid, lang);
}

Version Control with Sitecore and Subversion

Tue, 07 Dec 2010 22:07:00 -0500

This post will be very brief because I mainly wanted to share a link to a Sitecore Developer Network Article that walks through how you should use Subversion for your Sitecore projects. We use the same process at Oasis with Subversion. Pay close attention to the ALL CAPS note: "DO NOT ADD PARTS OF SITECORE DISTRIBUTION TO SVN UNLESS YOU WANT TO MAKE AND TRACK MODIFICATIONS TO THEM."

We make sure that we do not commit files that are part of the Sitecore installation, unless we make changes to them. This way you can download any version of Sitecore that you want, checkout your SVN files, copy them on top of the Sitecore installed files, and now you have a new version of your code running on that version of Sitecore. Clearly, there are a few more steps, such as, configuration file considerations, but you get the general idea. If you keep your committed code separate from the Sitecore installation, it will be easier to manage your Sitecore version updates, and you won't fill your Subversion repositiory with unnecessary files. In addition, you will kill the performance of your repository if you fill it with the Sitecore folder under the website.

Here is the link to the article. http://sdn.sitecore.net/Developer/Team%20Development%20with%20Sitecore/Tuning%20Environmfent%20for%20Team%20Development/Developer%27s%20Workstation%20Installation/Creating%20a%20New%20Progect%20in%20SVN.aspx

Sitecore Caching with Sublayouts

Tue, 30 Nov 2010 10:24:00 -0500

This post will walk through some of the great caching features that Sitecore provides using sublayouts. I will walk through 3 simple examples to get you starting with using sublayouts to cache content. Once you get the basics, there are many more ways to use caching to meet the needs of your web applications. Here are the 3 examples:

Static Content – Same for All Users
Dynamic Content – Vary by Logged-In State
Dynamic Content – Vary by SessionID & AccountID

The following examples use hard-coded sublayout tags you can drop into your Layout code, but the same concepts apply when using the dynamic Presentation layer in Sitecore.

FTP Client from Sitecore Codebehind

Wed, 27 Oct 2010 20:53:00 -0400

Have you ever wanted to download files from an FTP server with ASP.NET code? If so, you probably considered a few different paths: (1) buy some code or a DLL for the FTP Client, (2) build your own class library, or (3) search from something built-in to ASP.NET.

This article is going to discuss the third option. There are some built-in classes that you can use in ASP.NET 3.5 even though the articles are titled .NET v4.0. I can confirm that this code works on a Sitecore 6.2 website that is running ASP.NET 3.5 and not 4.0.

Download FTP Client Samples Here:

http://code.msdn.microsoft.com/nclsamples/Release/ProjectReleases.aspx?ReleaseId=3503

http://msdn.microsoft.com/en-us/library/b7810t5c%28v=VS.90%29.aspx

Click into the article detail to view the key source code.

Sitecore Configuration API

Wed, 20 Oct 2010 20:16:00 -0400

Here is a very helpful class that is not so often discussed... the Sitecore.Configuration class, and it is super easy to use.

Below is a simple code example of how this class can be helpful. We all know that Sitecore's Web.config file is loaded with more settings and configuration attributes then any of us can explain. Therefore, it could be common that you would want to know some of these settings in your C# code.

For example, you could have a page that you only want Sitecore Admin users to view and redirect them to the specific type of error page if they are not logged in as an Admin (i.e. permission denied or No Access URL). Here is how you would code that:

if (!Sitecore.Context.User.IsAdministrator) {
    Response.Redirect(Sitecore.Configuration.Settings.NoAccessUrl);
}

Click Event Handlers Hackery

Mon, 11 Oct 2010 21:05:00 -0400

Another interesting need came about today working with the Sitecore Ecommerce Module because most of the module is compiled into a DLL. There came about a need to update a value when the click event was fired, but the click event was in the DLL. Therefore, to avoid rewriting the event by copying code from the Reflector tool, I removed the event in the Page_Init that I added to the ASPX file. This allowed me to add my own event btnUpdate_Click2 to the ASPX file.

So, the question is, are these events synchronous or asynchronous? All testing so far has indicated that the events are asynchronous, meaning that they run in order and not at the same time. The code below shows how this was done.

btnUpdate.Click -= btnUpdate_Click;
btnUpdate.Click += new EventHandler(btnUpdate_Click2);
btnUpdate.Click += btnUpdate_Click;

Selecting CSS Class Names with Dots Using jQuery

Mon, 04 Oct 2010 21:26:00 -0400

Another day... another unique issue. The title of the post pretty much summarizes the new issue. Working with someone else's code, you don't have control over naming conventions of CSS classes, and I just happened to be using code that has dots in the CSS class names. I know what you are thinking. Isn't that illegal? Well, apparenltly, you can do it, but I wouldn't. So, I will say this is how to work with it if you are using someone else's code because you would never code dots in your CSS class names.

So, here is the jQuery code to select CSS class names with dots. You need to escape the dot with two backslashes. I won't reveal the source of the "unconventional" CSS code, but you may be able to tell from this example.

// Hide fields on Checkout Name and Address form
$(".name\\.Country").hide();
$(".name\\.ShippingCountry").hide();

How to Build an XSLT Extension

Thu, 30 Sep 2010 22:30:00 -0400

I know that most of us developers hate using XSLT, but what if someone else wrote the XSLT for you and you just wanted to make a few tweaks to it. Then, you might like the XSLT because it's already done. Therefore, you need to understand how it works and how you can write C# code to make some simple changes. Here is a code example from the Sitecore Ecommerce Module, where I wanted to override the GetSinglePrice method in an XSLT rendering.

Step 1 : This first thing you need to do is write your own class like the following that inherits from the Sitecore.Xml.Xsl.XslHelper class.

class XslExtensions : Sitecore.Xml.Xsl.XslHelper
    {
        public string GetSinglePrice(XPathNodeIterator ni) {
            IProduct product = 
               Sitecore.Ecommerce.Context.Entity.Resolve<IProduct>();
            IPriceParameters priceParams =
               Sitecore.Ecommerce.Context.Entity.Resolve<IPriceParameters>();

            return String.Format("{0:C}", product.GetSinglePrice(priceParams));
        }
    }

Read the full article for the next steps.

Sitecore Shared Source Modules

Sat, 25 Sep 2010 18:47:00 -0400

If you aren’t familiar with the Sitecore Shared Source Modules, you are missing out on some great tools. This past week, we made use of another great module, the Account Selector Field module (http://trac.sitecore.net/AccountSelectorField).

Click through to read the full post.

Sitecore.DateUtil - The Useful Sitecore Utility You Never Heard Of

Wed, 15 Sep 2010 22:00:00 -0400

If you want to convert an ASP.NET DateTime object to a Sitecore ISO Date String, you should use this method Sitecore.DateUtil.ToIsoDate or Sitecore.DateUtil.ToIsoTime

No need to re-invent the wheel here. So, delete your internal methods from your libraries because I assume you have already done this on your own, not knowing that this already existed for you.

By the way, there are some other methods in the DateUtil class also, so check them out too.

Sitecore XPath Query Gotcha

Wed, 08 Sep 2010 20:55:00 -0400

Here is one of the classic gotcha's the we often come across. The dreaded "-" dashes in node names.

query:/sitecore/content/#My-Site#/Home/*[@@templatename='mytemplate']

You have to keep in mind that item names with "-" dashes should be enclosed with "#" hash symbols. Otherwise, it will not work for you.

Good luck!

Linking To An Item in the Content Editor

Wed, 25 Aug 2010 22:11:00 -0400

This is a cool trick if you are building custom Apps or Tabs in the Sitecore Desktop. If you want to link to an item, you just need the Guid of the item to link to and follow the following URL structure. If you want it to open in a new browser window, you can set the target="_blank" and that will work too.

/sitecore/shell/sitecore/content/Applications/Content%20Editor.aspx?id={Guid}&la=en&fo={Guid}

Dot NET Events

Wed, 18 Aug 2010 19:44:00 -0400

I know this is a Sitecore Blog, but I feel the need to share a .NET tip this week that can be used in all of your Sitecore projects as well. In the past, I used to add .NET events handlers on the ASPX code like the following.

< asp : Repeater runat ="server" ID ="Repeater1" OnItemDataBound ="Repeater1_ItemDataBound">

Read more to see the better way that I use now.

Building a Sitecore Website Zip

Wed, 04 Aug 2010 16:10:00 -0400

The following steps will help you reduce the temp files that are not needed in your zip file.

Delete Website\sitecore\shell\Applications\debug
Delete Website\sitecore\shell\Controls\debug
Delete everything from Data folder except license file, folders, and packages
Delete Website\App_Data\MediaCache – delete the whole MediaCache folder
Delete Website\temp\* - keep the folder and delete all items
Delete all items in Website\indexes\* - keep the folder
Edit the ConnectionStrings.config file and delete the logins
Be prepared to update the dataFolder in the Web.config file

Tracking Downloaded Files with OMS

Wed, 21 Jul 2010 12:21:00 -0400

Before you get started with the OMS, you should check out Nick Laidlaw's Post about how to setup the analytics database.

How to use Parameters

Fri, 09 Jul 2010 16:51:00 -0400

Parameters are useful when you want to reuse the functionality of a Sitecore control, like a Rendering, and vary the way it functions by controlling this behavior in Sitecore rather than in .NET code.

One of the confusing parts about using Parameters is figuring out where you should edit them and how. They can be found on a Rendering item in the Parameters field of the Data section. The field delimiters are an undocumented mystery. However, after multiple searches through both Google and the SDN, the answer was found in a completely unrelated blog article (Thanks to John West). The delimiter is an ampersand character, so these basically use Query String format.

Can't Login to Sitecore?

Wed, 30 Jun 2010 14:17:00 -0400

Have you ever been locked out of your Sitecore login or have you forgotten or lost all know logins? Don't worry, as long as you have access to the SQL Server database, you can take the following steps to get logged in again. Read more for solution.

Aliases with Multiple Sites

Wed, 16 Jun 2010 21:22:00 -0400

Beware of using Aliases in a Sitecore install that is running multiple sites. We all know that you can run multiple sites on the same Sitecore install by using different hostName attributes on the <sites> node in the Web.config file. However, you can't have the same aliases across multiple sites. For example, if you have a Solutions alias in your Sitecore install as shown below, this Alias can only point to one node in the content tree. Therefore, it will point to that same node in the content tree for all "sites." This can sometimes come by surprise and bewilderment if you inherit a project that is using aliases. I recommend checking the location in the System folder shown below in the tree to see if there are any Aliases to be aware of.

Will additional development resources provide significant efficiencies with Sitecore development projects?

Wed, 02 Jun 2010 17:30:00 -0400

Basic Conclusion
At Oasis we suggest that the ideal project team for a typical Sitecore project consists of a maximum of 3 development resources and 2 project managers. The division consists of a chief architect that provides coordination, programming guidance, and QA controls, a front-end developer that provides expertise in HTML, CSS, and JavaScript, and a back-end developer that provides expertise in Sitecore API and ASP.NET backend coding. This team division provides each member with clearly defined roles that avoid reworking the same tasks that have already been completed by another programmer because the scope of each developer does not overlap. The project managers consist of a day-to-day project leader that facilitates communication between the client and development resources on a daily basis, and the second project manager is a typically a more senior and less involved manager on a daily basis. Their responsibility is to be the client’s internal champion and to keep in mind the broader perspective and overall project objectives. The team approach provides defined roles and cooperation that far exceed the capabilities of individuals wearing multiple hats. Check out the full post for supporting language and data.

How to Remove Upload as Files Checkbox

Wed, 26 May 2010 12:02:00 -0400

I have seen a common problem with Sitecore Media Library assets. If users upload the files As Files using the checkbox shown below, you can run into problems in load balanced environments and environments with different websites for the Stage and Live databases.

When you publish the media assets, their container or pointer is moved from the master to the web database in Sitecore, but the file assets in the file system are not moved by Sitecore. You could setup a file replication application, but who wants to do that when there is an easier way. Read on for the solution.

Access to the path is denied

Wed, 12 May 2010 23:38:00 -0400

Have you ever zipped up a Sitecore website to move it to another server and received an error like the following?

Access to the path 'c:\…\website\sitecore\shell\applications\debug\ducatshell.cs' is denied.

It is common to get this error because the debug folders to written to the file system by Sitecore at run time. Therefore, the permissions on the folders are tied to the ASPNET user from the source machine, which prevents the destination machine from being able to re-write those files.

Staging Module Publishing Targets

Wed, 28 Apr 2010 13:31:00 -0400

The Sitecore Staging Module works great, allowing you to have a authoring environment on a local web server and publish content over the internet up to a hosted server containing a separate instance of Sitecore. There is a good PDF document that gets you on the right track for configuring the Staging Module titled, "Staging Module Installation and Configuration Guide." However, there is one key step that you may miss by following along in this guide. You will want to edit the following section of your Web.config file.



<setting name="DefaultPublishingTargets" value="Internet|WebSQL" />

EviBlog Install and Setup Instructions

Wed, 14 Apr 2010 23:05:00 -0400

The EviBlog is located in the Sitecore Shared Source Library at http://trac.sitecore.net/EviBlog

According to the Installation Guide, all you need to do is install the package and publish the site. However, this did not work for me. I was missing the items in the content tree. I inspected the package.zip file for version 1.5, and there were definately no items in the content tree. So, then I checked out the SVN module.

Welcome

Tue, 13 Apr 2010 00:15:00 -0400

Hello all Sitecore developers. I will be using this blog to share my experiences and insights with Sitecore. I hope you find some of my tips helpful, and please share your comments with me too.