<%@ Register Tagprefix="SharePoint"
Namespace=”Microsoft.SharePoint.WebControls” Assembly=”Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c” %>
<%@ Register Tagprefix="Utilities"
Namespace=”Microsoft.SharePoint.Utilities” Assembly=”Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c” %>
<%@ Register TagPrefix="wssawc"
Namespace=”Microsoft.SharePoint.WebControls” Assembly=”Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c”%>

    Global Site Feature Management

    Global Site Feature Management

    Use this page to activate or deactivate site-scoped Features across all sites based on the selected site definition for the selected Web Application.

   
       

       
                             

               

               
                       
          

            <!– ****************************************
                 DISPLAY THE AVAILABLE FEATURES
                 USING THE InputFormSecton AND ASP:RadioButtonList CONTROLS –>
            <wssuc:InputFormSection runat="server"
                Title=”Site Feature”
                Description=”Select a site feature from the list” >
               
               

                   

               

           
               
           
           

            <!– *******************************************
                 DISPLAY A SECTION TO SPECIFY THE ACTION TO
                 PERFORM WITH THE FEATURE–>
            <wssuc:InputFormSection runat="server"
                Title=”Action”
                Description=”Specify if activating or deactivating the selected Feature.” >
               
               

                   

               

           
               
           
           

            <!– *******************************************
                 DISPLAY A SECTION TO SPECIFY IF THE FEATURE ACTIVATION
                 SHOULD BE FORCED –>
            <wssuc:InputFormSection runat="server"
                Title=”Force Feature Activation / Deactivation”
                Description=”Check here to force feature activation or deactivation.” >
               
               

                   

               

           
               
           
           

            <!– *******************************************
                 DISPLAY THE AVAILABLE SITE DEFINITIONS
                 USING THE InputFormSecton AND ASP:CheckBoxList CONTROLS –>
            <wssuc:InputFormSection runat="server"
                Title=”Site Definitions”
                Description=”Select the site definitions to which the
                                 feature will be applied” >
               
               

                   

               

           
               
           
                       

            <!– ****************************
                 OK AND CANCEL BUTTON SECTION –>
            <wssuc:ButtonSection runat="server" TopButtons="false" 
                BottomSpacing=”5″ ShowSectionLine=”true”>
               
                    <asp:Button UseSubmitBehavior="false" runat="server"
                       class=”ms-ButtonHeightWidth” OnClick=”BtnSubmit_Click”
                       Text=”" 
                       id=”BtnSubmitBottom”
                       accesskey=”" 
                       Enabled=”true”/>
               
           
           
         

       

       

<!– *****************************************                  USE SHAREPOINT THE ButtonSection CONTROL                  TO DISPLAY THE “OK” AND “CANCEL” BUTTONS –>             <wssuc:ButtonSection runat="server" TopButtons="true"                 BottomSpacing=”5″ ShowSectionLine=”false”>                                     <asp:Button UseSubmitBehavior="false" runat="server"                         class=”ms-ButtonHeightWidth” OnClick=”BtnSubmit_Click”                         Text=”"                         id=”btnSubmitTop”                         accesskey=”"                         Enabled=”true”/>                                                     <!– **************************************                  DISPLAY THE WEB APPLICATION SELECTOR                  USING THE InputFormSecton AND WebApplicationSelector CONTROLS.                  THE TITLE AND DESCRIPTION ARE SPECIFIED IN THE CORRESPONDING                  ATTRIBUTES OF THE InputFormSection CONTROL, WHILE THE CONTROLS                  THEMSELVES ARE PLACED INSIDE THE InputFormControl SECTION –>             <wssuc:InputFormSection runat="server"                 Title=”Web Application”                 Description=”Select a Web Application” >

<SharePoint:WebApplicationSelector id="Selector" runat="server"                             TypeLabelCssClass=”ms-listheaderlabel”                             AllowAdministrationWebApplication=”true” />

<!– Use a SharePoint Required Field Validator to ensure                          that a web application is selected –>                     <wssawc:InputFormRequiredFieldValidator                             ID=”ReqValAppPoolPassword”                             ControlToValidate=”rdSiteFeatures”                             ErrorMessage=”You must select a Feature to activate”                             Runat=”server” />                     <asp:RadioButtonList ID="rdSiteFeatures" runat="server"                             CssClass=”ms-listheaderlabel” EnableViewState=”true” />

<asp:DropDownList ID="lstAction" runat="server"                          EnableViewState=”true”>

<asp:CheckBox ID="chkForce" runat="server"                            EnableViewState=”true” Text=”Force”                           CssClass=”ms-listheaderlabel”  />

<asp:CheckBox ID="chkSelectAll" runat="server"                             CssClass=”ms-listheaderlabel”                              Text=”Select All Click here to select all site                                     definitions.”                             OnCheckedChanged=”chkSelectAll_Changed”                             AutoPostBack=”true”  />                         <asp:CheckBoxList ID="chkListSiteDefinitions" runat="server"                             CssClass=”ms-listheaderlabel” AutoPostBack=”false” />

   

   

//Get the regional localeID and Culture Information (Regional Settings)
//these will be used to retrieve the list of features and 
//site definitions
int localeID = (int)SPContext.Current.RegionalSettings.LocaleId;
System.Globalization.CultureInfo cInfo = new System.Globalization.CultureInfo(localeID);

//Get a reference to the farm object we will use it
//to retrieve the feature definitions
SPFarm thisFarm = SPFarm.Local;
foreach (SPFeatureDefinition featureDefinition in thisFarm.FeatureDefinitions)
{
    //Check that each feature is scoped at the web level and 
    //that it is not hidden before adding it to the list
    if ((featureDefinition.Scope == SPFeatureScope.Web) && !(featureDefinition.Hidden))
    {
        ListItem siteFeatureItem = new ListItem("" + featureDefinition.GetTitle(cInfo) + "
 " 
                                + featureDefinition.GetDescription(cInfo), featureDefinition.Id.ToString());
        rdSiteFeatures.Items.Add(siteFeatureItem);
    }
}

//Get the list of available Site Definitions / WebTemplates
foreach (SPWebTemplate webTemplate in SPContext.Current.Site.GetWebTemplates(SPContext.Current.RegionalSettings.LocaleId))
{
    //Skip "GLOBAL", it has an ID of 0
    if (webTemplate.ID != 0)
    {
        ListItem webTemplateItem = new ListItem("" + webTemplate.Title + " - ID: " + webTemplate.ID + " Name: " + webTemplate.Name + "
" + webTemplate.Description,webTemplate.Name);
        chkListSiteDefinitions.Items.Add(webTemplateItem);
    }
}     

//*************************************************************
// This method is called when the user clicks the "OK" button
// to activate the site feature. 
protected void BtnSubmit_Click(object sender, EventArgs e)
{
    //Prepare a string object to display the result
    //of the feature activation for each site
    string strMessages = "";
    
    //Hide the form
    inputForm.Visible = false;
    
    //Get the GUID of the selected Feature to activate
    Guid featureID = new Guid(rdSiteFeatures.SelectedValue);

    try
    {
        //Iterate through each of the site collections
        //in the selected web applications 
        foreach (SPSite site in Selector.CurrentItem.Sites)
        {
            //Disable the CatchAccessDeniedException
            //of the site collection to avoid being redirected
            //to the "Access Denied" page if access is denied.
            site.CatchAccessDeniedException = false;
            
            //Iterate through each site in the site collection
            //and activate the selected feature
            foreach (SPWeb web in site.AllWebs)
            {
                //Use a try statement to trap any errors that
                //may occur during activation. Errors may occur
                //due to feature dependencies, features that
                //may already be active, permissions, etc. 
                //Consider Refactoring this code for better error 
                //handling
                try
                {
                    //Check if the site definition/configuration of the 
                    //current site is included in the list of site definitions
                    //that the feature will be applied to.
                    ListItem item = chkListSiteDefinitions.Items.FindByValue(web.WebTemplate + "#" + web.Configuration.ToString());
                    if ((item != null) & (item.Selected))
                    {
                        //Activate the feature
                        if (lstAction.SelectedValue == "Activate")
                        {
                            web.Features.Add(featureID, chkForce.Checked);
                            strMessages += "
Feature Successfully Activated: " + web.Url + "
";
                        }
                        else
                        {
                            web.Features.Remove(featureID, chkForce.Checked);
                            strMessages += "
Feature Successfully Deactivated: " + web.Url + "
";
                        }
                        
                    }
                }
                catch (Exception featureActivationError)
                {
                    //if an error occurs during activation;
                    //capture the message to display it to the user
                    //after iterating through all the sites
                    strMessages += "
Feature Activation Error: " + web.Url + " ERROR:" + featureActivationError.Message + "
";
                } 
            }
            //Allow the site collection to continue handling
            //access denied exceptions
            site.CatchAccessDeniedException = true;
        } 
    }
    catch (Exception featureActivationError) 
    { 
        //if an error occurs write the error message to 
        //an error element 
        strMessages += featureActivationError.Message + "hhhhhh
";
    }
}

Save the application page to the “ADMIN” folder in the 12 hive’s template directory, usually C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\ADMIN\. The complete code sample of the application page includes additional error handling and security logic to validate the users roles and page request.

With the application page created and saved to the ADMIN folder, it can be called and ran from the browser via the Central Administration site’s URL followed by “_admin/pagename.aspx” (i.e. http://centraladminsite/_admin/sitefeaturemanagement.aspx).

To add a link to the page from the Application Management Section of the Central Administration Web Site, we’ll need to create a farm feature. Create a new folder in the feature directory and name it “SiteFeatureAdministration”. Create a Feature.xml file in the newly created folder with the following code:

<?xml version="1.0" encoding="utf-8" ?>
<Feature xmlns="http://schemas.microsoft.com/sharepoint/"
         Id="4D4F4516-DDEC-4ea8-82F4-124D1B743984"
         Title="Site Scoped Feature Management"
         Hidden="FALSE"
         Scope="Farm"
         ActivateOnDefault="TRUE"
         Version="12.0.0.0">
    
        <ElementManifest Location="Elements.xml" />
    

This file tells SharePoint that the feature is scoped at the farm level and is to be activated by default. The elements.xml file referenced will contain the instructions of what the feature should do.

Next create an elements.xml file in the SiteFeatureAdministration folder with the following code:

<?xml version="1.0" encoding="utf-8" ?>
<Elements xmlns="http://schemas.microsoft.com/sharepoint/">
    <CustomActionGroup
    Id="BDDBB947-CBC6-47f7-B57A-6C8BEB0E19D7"
    Location="Microsoft.SharePoint.Administration.ApplicationManagement"
    Title="Utilities"
    Sequence="1000"/>
    <CustomAction 
        Id="E57ECD33-91FD-4fc3-A4E8-E1B932178CB4"
        GroupId="BDDBB947-CBC6-47f7-B57A-6C8BEB0E19D7" 
        Location="Microsoft.SharePoint.Administration.ApplicationManagement"
        Sequence="20"
        Title="Site Scoped Feature Management"
        Description="">
        <UrlAction Url="_admin/SiteFeatureManagement.aspx"/>
    

The “CustomActionGroup” element tells SharePoint to create a new section titled “Utilities” in the Application Management Section of the Central Administration site. The “CustomAction” element gives the link a name and adds it to the CustomActionGroup. The “UrlAction” element specifies the URL of the link.

Deploy the feature using your preferred method. Go to the Application Management page in the Central Administration, you should see the Utilities Section with a link to the Site Feature Management page.

When creating custom solutions for SharePoint its always a good idea to use Solution Packages. They provide ease of deployment and upgrading capabilities for your custom application pages, features, web parts, and custom site definitions to all of the servers in the farm. For more information on how to create, deploy, and work with solution packages, reference: http://msdn.microsoft.com/en-us/library/ms413687.aspx

You can download the full code samples from: http://www.rafelo.com/SiteFeatureManagmentCode.zip

You can download the solution package from:

http://www.rafelo.com/SiteFeatureManagementWSP.zip