View Pages
A View Page is a custom page that can be embedded within the DonorPoint admin application or the donor-facing engage application. View Pages allow you to build custom screens — dashboards, tools, summaries, or interactive forms — using DonorPoint’s full XHTML and expression language capabilities.
Where View Pages Appear
View Pages can be linked from:
- The sidebar navigation (configured by your account administrator)
- The right-hand sidebar of any record type (via Entity Actions)
- Custom navigation links in the admin application
- The donor portal for account-specific self-service tools
View Page Configuration
| Field | Description |
|---|---|
| Name | Display name shown in navigation links |
| Description | Internal description |
| Status | Published (visible) or Draft (hidden) |
| Application | The DonorPoint application this page belongs to: /admin (staff admin), /engage (donor-facing engage), /store (commerce store), or unset for global access. The application context controls which sidebar links and RHS actions the page can show, what authentication is required, and which contextual variables (user, account, campaign, etc.) are available |
| Public | Whether anonymous (not logged-in) users can access this page |
| Rendered Rule | Expression that controls when this page is visible in navigation |
| Parameters | Named parameters passed in the URL query string and available in the page |
| Setup Script | Script that runs before the page renders — used to prepare data and set variables |
| Redirect URL | Optional redirect to a different page after the setup script runs |
| Social Settings | Open Graph metadata if the page is publicly shared |
Application-Aware RHS Links
When a ViewPage is assigned to the /admin application, its right-hand sidebar automatically shows the same edit-page navigation links available on entity edit pages (Schedule, Webhook, Run Reports, Entity Actions, etc.). This makes ViewPages first-class dashboard surfaces that integrate cleanly with the admin shell. ViewPages assigned to /engage or /store render in the donor-facing layout with the matching navigation.
Setup Script
The Setup Script runs before the page is rendered. It can:
- Query the database for data to display
- Redirect the user to another page based on conditions
- Set variables that the page content references
Variables set in the Setup Script are available in the page body as expression language references.
Parameters
View Pages accept URL parameters that can be used in the page body and Setup Script. For example, a View Page showing details for a specific fund can accept a fundId parameter and use it to look up and display that fund’s data.
Tabs
| Tab | Content |
|---|---|
| Definition | Name, description, status, public flag, rendered rule, redirect URL |
| Setup Script | Script executed before the page renders |
| Sharing | Social settings and sharing configuration |
Use Cases
- Custom reporting views not suited to standard List Reports
- Admin tools for bulk operations using DonorPoint scripting
- Donor-facing self-service pages beyond the standard portal tabs
- Landing pages for specific campaigns with custom data displays