Salesforce.com Foundation Salesforce.com Foundation
Nonprofit Starter Pack Documentation » Install & Uninstall » Installing the Nonprofit Starter Pack

This is core documentation for the Nonprofit Starter Pack. You can find more technical documentation, including release notes on the Wiki.

Discussion and help forums are located on Google Groups. NPSP Users, NPSP Discuss, and the more general Nonprofit Salesforce Practitioners group may be helpful.

We have a public issue tracker for known issues and feature requests on our Google Code Project.

For more information about the Salesforce.com Foundation, please visit our website.

Last Updated

Sep 14, 2011

Download Lesson PDF

Other Resources

  • Contacts and Organizations

  • Contacts and Organizations (2.1.x)
  • Households

  • Households (2.3.x)
  • Affiliations

  • Affiliations (1.55)
  • Recurring Donations

  • Recurring Donations (2.0.x)
  • Data Management

  • Working With Bulk Data in the NPSP
  • Install & Uninstall

  • Install & Uninstall

Comments

4 comments for this lesson

  • Prev: Uninstalling the Nonprofit Starter Pack

Installing the Nonprofit Starter Pack

This lesson will show you how to install a managed version of the Nonprofit Starter Pack into a blank Enterprise Edition, or Developer Edition organization. When complete with the steps, you should have an org that is virtually identitical to the pre-installed and configured Nonprofit Starter Pack available through the salesforcefoundation.org trial signup.

(Note: If you're using a Developer Edition org, it is recommended that you remove the page, controller and tab included as part of the Developer Edition. The recommended deletion order is: Tab->Pages->Classes)

Install the 5 Packages

Media_1316010544942_display

You'll first need to install all five packages of the Nonprofit Starter Pack. The recommend install order is: Contacts & Organizations first, then any order of the remaining four packages: Recurring Donations, Affiliations, Relationships and Households.

You can find the packages by going to Nonprofitstarterpack.org

When installing, make sure to "Grant access to all users". You'll need to get confirmation that each package has installed successfully before attempting to install the next.

Confirm Installation

Media_1316014574360_display Zoom

When complete, clicking on Setup (1) and then View Installed Packages (2) should show all five of your packages installed (3).

Create Apps

Media_1316014819677_display Zoom

Next, we'll want to setup two new NPSP-specific apps to hold our tabs. One for our CRM, the other for the NPSP settings. We can do this by going to Setup (1), Create (2), Apps(3) and then clicking 'New' (4). If prompted, select 'Custom App'.

You'll then need to enter a name for your new app. This is the name that will appear in the drop-down list in the upper-righthand corner. You may choose any name you wish, the NPSP typically uses "Nonprofit CRM" and "Nonprofit Settings". You may also select a custom image to appear in the top-lefthand corner. Your organizations logo or picture may be used here. Please follow the help instructions for proper sizing and aspect rations for the image.

Selecting Tabs for your App

Media_1316015186278_display Zoom

You'll next need to select tabs for your app. For your Nonprofit CRM app, the NPSP typically uses the following tabs:
Home, Chatter, Accounts, Contacts, Opportunities, Campaigns, Reports, Dashboards, Documents, Leads, Recurring Donations & Pledges

For your Nonprofit Settings app, the NPSP typically uses:
Contacts Settings, Households Settings, Opportunity Rollups, Affiliation Settings, User Rollups, About the Nonprofit Starter Pack

Click 'Next' to determine your Profile settings (more information below)

Setting Profile Visibility and Defaults for your Apps

Media_1316015287021_display Zoom

You'll next need to select the visibility of your app, as well as the default app for each of the profiles in your org. We recommend making the Nonprofit CRM visible and the default for most internal (non-portal) users, and the Nonprofit Settings app visible only for the System Administrator.

(Note: The profiles available in your organization may differ from the ones listed above)

Removing Other Apps from View

Media_1316015733324_display Zoom

You can optionally remove the visibility of other apps in your org. This is done on a profile-by-profile basis. Select the profile you want to edit by going to Setup (1) and then Manage Users (2) and the Profiles (3). Click 'Edit' next to the profile you wish to edit (not shown).

Finally, deselect any checkboxes for apps you do not wish to be visible for that profile (4). Click 'Save' when done (5).

Stage Name Values

Media_1316018567399_display Zoom

Next, you'll want to decide your stage name values for your Sales Process. You can use the default values provided, or create/modify your own.

A Sales Process is simply a collection or subset of the picklist values associated with the Stage Name field. You can edit those stage name values by going to Setup (1), Customize (2), Opportunities (3), Field (4), and clicking on the Stage field (not shown). You can then either create new values (5), or edit existing values (6). For an Opportunity to be counted, you'll need to make sure your 'closed' stage is also set as 'Closed/Won'. (7)

Sales Processes

Media_1316018799166_display Zoom

You'll next need to create at least one Sales Process from your existing values.

Select Setup (1), Customize (2), Opportunities (3) and Sales Process (4). Then click 'New' (not shown) and provide a name for your Sales Process (not shown). You'll then need to select from the values available from the Stage Name above. You can choose to use the default ones, or create your own as appropriate. Here, we've selected three of the existing values (5). Click Save when done (6).

Opportunity Recordtypes

Media_1316019293379_display Zoom

Next we'll want to create at least one Opportunity Record Type, though you may choose to create more. You may choose to create your record types using whatever names are most appropriate to your organization. The Nonprofit Starter Pack has four enabled at signup, Donation, Grant, Membership and Major Gift. You can use those, or select your own.

To create record types, go to Setup (1), Customize (2), Opportunities (3), Record Types (4) and click "New" (not shown). Then provide a name, label, and select the Sales Process (5) you wish to use for this record type. Finally, make sure the record type is enabled for the correct profiles (6), and click 'Next' (7). You'll then need to select a layout for this record type. You can select the default 'Opportunity Layout' for now, we'll discuss page layouts more shortly. (not shown).

Visualforce Overrides

Media_1316019856274_display Zoom

The Nonprofit Starter Pack also utilizes two different Visualforce overrides for standard actions. The first is the 1x1 Account View, the second is for Lead Conversion. For the Accounts, you can override the view by going to Setup (1), Customize (2), Accounts (3), Buttons and Links (4) and then clicking 'Edit' next to 'View' (5). Select 'Override with Visualforce Page' and select 'AccountViewOverride' and click 'Save' (not shown).

You'll then need to do the same for Lead Conversion. Setup (1), Customize (2), Leads (not shown), Buttons and Links and then clicking 'Edit' next to 'Convert'. Select 'Override with Visualforce Page' and select leadConvertOverride and click 'Save' (not shown).

Renaming Tabs

Media_1316020263156_display Zoom

When signed up through the Salesforcefoundation.org website, the Nonprofit Starter Pack relabels Accounts as Organizations, and Opportunities as Donations. You can do the same by going to Setup (1), Customize (2), Tab Names and Labels (3) and clicking 'Rename Tabs and Labels. Then click 'Edit' next to Accounts (4) and provide the new name for Accounts, and click 'Save' (not shown).

The process is the same for Opportunities.

Turn on Workflow

Media_1316020619921_display Zoom

The workflow that comes with the Nonprofit Starter Pack is disabled by default, you'll want to enable it. You can do so by going to Setup (1), Create (2), Workflow & Approvals (3), and then Workflow Rules (4). Click 'Activate' next to the workflow rules your organization wishes to use (5). If you're installing into an existing organization, you'll want to make sure you fully understand the implications of the workflow being enabled before installing. It is always recommended to test in a sandbox environment first.

The first 9 workflow rules are recommended for all organizations utilizing the Nonprofit Starter Pack.

Opportunity Contact Roles

Media_1316021052287_display Zoom

It is recommended that you create at least two new Opportunity Contact Roles. You can do this by going to Setup (1), Customize (2), Opportunities (3) and selecting Contact Roles (4). Click 'New' (5), and create two new roles, 'Donor' and 'Household Member'.

Note: DO NOT SET A DEFAULT Opportunity Contact Role!

Configure Contacts Settings

Media_1316021379606_display Zoom

Next you'll want to configure your Contacts Settings. You can do this by selecting your Nonprofit Settings app (1), then the Contacts Settings tab (2). The default settings for the Nonprofit Starter Pack are using the One-to-One Account model (3). You can find more information about the Account model under the Contacts & Organizations section of this help site. Next, enable the Opportunity Contact Role trigger by checking the box (4). Then select your Default Role as 'Donor' (5). Finally, click 'Update the Contacts and Organizations Settings to confirm your selections (6).

Configure Households Settings

Media_1316021476069_display Zoom

Next you'll want to configure your Households Settings. You can do this by selecting your Nonprofit Settings app (1), then the Households Settings tab (2). The following settings are the defaults for the Nonprofit Starter Pack, you'll want to configure them as appropriate for your organization:
3. Household Rules set to 'All New or Edited Contacts'
4. Household Contact Roles are checked, and Household Member Contact Role is set to 'Household Member'
5. Rollup Opps in Triggers is checked
6. Click Activate Advanced Household Naming
7. Select the 'Membership' record type as your Membership Record Type Name, and set your Membership Grace Period to 30.
8. Check 'Enable Update Check'
9. Click 'Update the Households Settings'

Page Layouts

You have several options to configure your page layouts. If you're comfortable with the Force.com IDE and the meta-data API, you can pull the default NPSP page layouts from SVN. The URL for the repository can be found here: https://npsp.googlecode.com/svn/NPSP_layouts/src/layouts

Alternately, you can duplicate the layouts from the trial signup by manully copying them from below. There are four main layouts: Contacts, Accounts and two Opportunity Layouts. For the Opportunity layouts, you'll need to assign the layout to the appropriate record type. This can be found by going to Setup->Customize->Opportunities->Page Layouts->Page Layout Assignment.

 

Contact Layout

Media_1316029130402_display Zoom

Account Layout

Media_1316029223777_display Zoom

Donation Layout

Media_1316029307685_display

Membership Layout

Media_1316029383018_display
  • Prev: Uninstalling the Nonprofit Starter Pack

Comments (4)

nawaz Tuesday Jan 24 at 07:24 AM

hi..........

Eden Wednesday Mar 21 at 03:35 PM

The last section of the setup is very confusing. Could you please provide a step-by-step guide to the Page Layout Assignments.

Also, are the Donation Layout and Membership Layout different 'Opportunity Page Layouts' or are they both one the same Page layout and is this the default 'Opportunity Layout'???

Kevin Thursday Mar 22 at 07:16 AM

If you do a Google search on "salesforce modifying page layouts" the first two results provide step-by-step instructions for modifying a layout. The donation and membership layouts are associated with two different record types, if you choose to have them.

Gorav Seth Wednesday May 16 at 02:21 PM

Here are a few notes from installing the NPSP to a Developer Edition Org on 5.16.2012:

If installing into DE you need to create opp sales process and set up an opp record type first or else the C&O install will fail

This page needs to explain the notification regarding access by 3rd party websites that pops up

I think you can remove the following text - it does not appear to apply any more? I could not find the page controller or tab referenced in it:
(Note: If you're using a Developer Edition org, it is recommended that you remove the page, controller and tab included as part of the Developer Edition. The recommended deletion order is: Tab->Pages->Classes)

This page is missing Batch Data Entry App installation instructions? Appears to be part of the default NPSP install now.

The Contact Settings screenshot appears to be missing a few new settings:
-Payment Configuration
-Lead Conversion Configuration
-Package Update Information & Configuration

Add your comment

E-Mail me when someone replies to this comment