Slate provides a Slate.org Organization Portal template that can be imported using Briefcase and edited in an institution's database. This portal is configured to display custom institutional information.
Suitcase: a582abc7-74f5-4844-a592-c7f9fe05dc90:slate-showcaseThe portal template will be added with a key of slateorg-organization and should not be modified.
Your institution can create new Slate.org Organization and Slate.org Application portals in the Portal Editor.
Important!
Be sure to enable Slate.org Application Sharing.
- Click Database in the top navigation bar and select Slate.org Application Sharing Settings.
- Review the Rounds, Application Status, Checklists, Materials, and Decisions sections.
- Click an individual item. Then, select either:
- Share with Slate.org institutions
- Do not share with Slate.org institutions
Click the Slate Scholar Lightbulb in the top left corner for a complete listing of all setting descriptions.
Create the Portal Query
Once you've imported the Slate.org Organization portal via Briefcase, customize its exports to return the data points that will display in the portal. We'll start with a Configurable Joins - Organizations query to pull a list of exports you can use in merge fields and dynamic content blocks.
To customize the portal exports:
- From All Portals, select your Slate.org Organization Portal from the list.
- Under Queries, click New Query.
- Configure the following in the New Query popup:
- Name: Organization Data
- Type: Configurable Joins
- Base: Organizations
- Click Save to start editing the query.
- Add any exports.
-
On the right, click Rename Exports. Ensure all export labels are lowercase and use underscores, not spaces. Click Save.
Note
By default, this query includes a filter called Portal Identity that you should not remove: it ensures the query will export the data of the matching organization in Slate.org.
If you accidentally remove the filter and need to add it back, its custom SQL is as follows:
(dr__JID_.[id] = @identity)No other filters are necessary for this query. The Portal Identity filter limits the results to just the organization viewing the portal in Slate.org.
Portal View (School View)
You can also edit the Organization Portal views to display any additional data points added to the queries, remove items, or change the portal's visual layout. The School view includes several static content blocks containing images, embedded media, and social media.
Tip
The customized content in the Slate.org Organization Portal will appear to the left of the standard Slate.org content, including a breakdown of what your institution is sharing via the Slate.org Application Sharing settings.
Portal Method (School View)
A portal method is needed to tie the portal query and view together. To configure the School View method:
- From All Portals, select your Slate.org Organization Portal from the list.
- Under Methods, select New Method.
- Configure the following in the Edit Details popup:
- Name: School View
- Type: GET
- Leave Action blank.
- View: School View
- Output Type: Default Branding
- Status: Active
- Click Save.
A list of queries display below these settings. This method is linked to the "Organization Data" query. To link any other additional queries:
- Click Edit Linked Queries in the top right.
- Select the additional queries.
- Click Save.
Testing
To test the Slate.org Organization portal:
- From All Portals, select your Slate.org Organization Portal from the list.
- On the right, select Impersonate.
- In the Record field, start typing the name of an organization record. Select the organization you'd like to impersonate from the list. For example, if you use Liquid markup or dynamic content blocks to show information based on a school's location, try impersonating schools based on region.
- Click Impersonate.
Best Practices
Avoid putting too much information in the portal. Consider what information is beneficial to counselors. Start simple, and then consider adding additional design elements, such as portal tabs and CSS styling elements.
Remember that portals are dynamic! Updated data and design elements within the portal will be immediately reflected in Slate.org.
Keep the portal status Inactive until ready to make live.