Skip to content
This repository was archived by the owner on Jan 30, 2024. It is now read-only.

Commit ec6cace

Browse files
mvogelgesangmvogelgesang
authored
Merge pull request #3 from GSA/dev-themepkg
Addresses #2 and includes updated INSTALLATION instructions to account for new code
2 parents cfd277d + 4dfe1e6 commit ec6cace

14 files changed

+674
-11
lines changed

‎INSTALLATION.md‎

Lines changed: 13 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -9,11 +9,11 @@
99
## Instructions
1010

1111
* Two methods available to push code to your sandbox
12-
* Install via https://test.salesforce.com/packaging/installPackage.apexp?p0=04t350000001l0y
12+
* Install via https://test.salesforce.com/packaging/installPackage.apexp?p0=04t350000001l13
1313
* Clone this repository and push
1414
* Enable Communities in your Salesforce org
1515
* Create new community (Setup > Communities > New)
16-
* Select Customer Account Portal
16+
* Select USWDS Lightning Community
1717
* Enter name of community and a community specific url (if desired)
1818
* From Workspaces, navigate to Administration
1919
* Login & Registration
@@ -22,7 +22,7 @@
2222
* Set Logout Page URL
2323
* Save
2424
* Update other settings as needed.
25-
25+
2626
### Experience Builder Setup
2727

2828
Navigate to Experience Builder by clicking Administration in the top left, and clicking Builder
@@ -36,15 +36,15 @@ This theme relies on five navigation menus:
3636
* Limit this nav to three or fewer entries
3737
* Main Footer Nav
3838
* Footer Secondary Nav
39-
* Many agencies require standard links on every website such as Privacy Policy, Accessibility, SORN, etc.
39+
* Many agencies require standard links on every website such as Privacy Policy, Accessibility, SORN, etc.
4040
* Social Media Nav
4141

4242
#### Change Theme Layout and Settings
4343

4444
* Settings > Theme > Configure
4545
* Change Theme Layout Component for the Default and Login Theme Layouts to USWDS Theme Layout. Accept alert and click OK.
4646
* Add Theme Images
47-
* Navigate to Theme (paint brush)
47+
* Navigate to Theme (paint brush)
4848
* Update Images
4949
* Upload your organization logo under Company Logo. Update Login Page Background Image if desired.
5050
* A logo with transparent background is best.
@@ -54,7 +54,14 @@ This theme relies on five navigation menus:
5454
* Enter navigation menu names for each Nav Menu Name section
5555
* If you plan to override a particular section, toggle the section on to reveal an Aura.Component[] drop zone
5656
* Update Theme Colors
57-
* Change Overlay Text Color from its default value of white to another color. Otherwise, users will not be able to find the Login and User Profile Menu sections of the theme.
57+
* This repository ships with base theme colors but can be customized to specific needs. While not comprehensive, the following maps color settings to components in the community.
58+
* Action Color
59+
* Tab Component (specifically active tab)
60+
* Tile Menu
61+
* Overlay Text Color
62+
* User Profile Menu
63+
* Detail Text Color
64+
* Tabs (inactive)
5865

5966
#### Add Font Awesome JS
6067

@@ -85,5 +92,3 @@ From Settings>Advanced.
8592
When saved you should not get any CSP errors.
8693

8794
### To Do
88-
89-
* Branding

‎src/aura/uswdsNavBar/uswdsNavBar.cmp-meta.xml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="UTF-8"?>
22
<AuraDefinitionBundle xmlns="http://soap.sforce.com/2006/04/metadata">
3-
<apiVersion>49.0</apiVersion>
3+
<apiVersion>48.0</apiVersion>
44
<description>USWDS navbar</description>
55
</AuraDefinitionBundle>

‎src/aura/uswdsTheme/uswdsTheme.cmp-meta.xml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="UTF-8"?>
22
<AuraDefinitionBundle xmlns="http://soap.sforce.com/2006/04/metadata">
3-
<apiVersion>49.0</apiVersion>
3+
<apiVersion>48.0</apiVersion>
44
<description>USWDS Theme</description>
55
</AuraDefinitionBundle>

‎src/brandingSets/USWDS_Lightning_Community.brandingSet‎

Lines changed: 109 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,109 @@
1+
<?xml version="1.0" encoding="UTF-8"?>
2+
<BrandingSet xmlns="http://soap.sforce.com/2006/04/metadata">
3+
<brandingSetProperty>
4+
<propertyName>HeaderBackgroundColor</propertyName>
5+
<propertyValue>#FFFFFF</propertyValue>
6+
</brandingSetProperty>
7+
<brandingSetProperty>
8+
<propertyName>TextTransformStyle</propertyName>
9+
<propertyValue>none</propertyValue>
10+
</brandingSetProperty>
11+
<brandingSetProperty>
12+
<propertyName>DetailTextColor</propertyName>
13+
<propertyValue>#5A5A5A</propertyValue>
14+
</brandingSetProperty>
15+
<brandingSetProperty>
16+
<propertyName>BorderColor</propertyName>
17+
<propertyValue>#D4D4D4</propertyValue>
18+
</brandingSetProperty>
19+
<brandingSetProperty>
20+
<propertyName>HeaderFonts</propertyName>
21+
<propertyValue>Ek Mukta</propertyValue>
22+
</brandingSetProperty>
23+
<brandingSetProperty>
24+
<propertyName>CardBackgroundColor</propertyName>
25+
<propertyValue>rgba(255, 255, 255, 0)</propertyValue>
26+
</brandingSetProperty>
27+
<brandingSetProperty>
28+
<propertyName>LoginBackgroundColor</propertyName>
29+
<propertyValue>#F4F4F4</propertyValue>
30+
</brandingSetProperty>
31+
<brandingSetProperty>
32+
<propertyName>_ActionColorTrans</propertyName>
33+
<propertyValue>rgba(25, 124, 190, 0.9)</propertyValue>
34+
</brandingSetProperty>
35+
<brandingSetProperty>
36+
<propertyName>LoginBackgroundImage</propertyName>
37+
<propertyValue>../../../../sfsites/picasso/core/external/salesforceIdentity/images/background.jpg?v=1</propertyValue>
38+
</brandingSetProperty>
39+
<brandingSetProperty>
40+
<propertyName>PageBackgroundColor</propertyName>
41+
<propertyValue>#F5F7FA</propertyValue>
42+
</brandingSetProperty>
43+
<brandingSetProperty>
44+
<propertyName>_HeaderTextColor</propertyName>
45+
<propertyValue>rgba(34,34,34,.8)</propertyValue>
46+
</brandingSetProperty>
47+
<brandingSetProperty>
48+
<propertyName>_NavigationMenuHoverColor</propertyName>
49+
<propertyValue>rgba(255,255,255,.2)</propertyValue>
50+
</brandingSetProperty>
51+
<brandingSetProperty>
52+
<propertyName>_HeaderInputBackgroundColor</propertyName>
53+
<propertyValue>rgba(255,255,255,.4)</propertyValue>
54+
</brandingSetProperty>
55+
<brandingSetProperty>
56+
<propertyName>TextColor</propertyName>
57+
<propertyValue>#222222</propertyValue>
58+
</brandingSetProperty>
59+
<brandingSetProperty>
60+
<propertyName>NavigationMenuTextColor</propertyName>
61+
<propertyValue>#222222</propertyValue>
62+
</brandingSetProperty>
63+
<brandingSetProperty>
64+
<propertyName>_HeaderPlaceholderTextColor</propertyName>
65+
<propertyValue>rgba(85,85,85,.8)</propertyValue>
66+
</brandingSetProperty>
67+
<brandingSetProperty>
68+
<propertyName>_OverlayTextColorShadow</propertyName>
69+
<propertyValue>#888</propertyValue>
70+
</brandingSetProperty>
71+
<brandingSetProperty>
72+
<propertyName>ActionColor</propertyName>
73+
<propertyValue>#0099DE</propertyValue>
74+
</brandingSetProperty>
75+
<brandingSetProperty>
76+
<propertyName>CompanyLogo</propertyName>
77+
<propertyValue>/file-asset/logo?v=1&amp;height=300&amp;width=300</propertyValue>
78+
</brandingSetProperty>
79+
<brandingSetProperty>
80+
<propertyName>_LinkColorDarker</propertyName>
81+
<propertyValue>#135F90</propertyValue>
82+
</brandingSetProperty>
83+
<brandingSetProperty>
84+
<propertyName>_ActionColorDarker</propertyName>
85+
<propertyValue>#135F90</propertyValue>
86+
</brandingSetProperty>
87+
<brandingSetProperty>
88+
<propertyName>_HoverColor</propertyName>
89+
<propertyValue>rgba(25, 124, 190, 0.05)</propertyValue>
90+
</brandingSetProperty>
91+
<brandingSetProperty>
92+
<propertyName>ErrorFontColor</propertyName>
93+
<propertyValue>#ff9e9e</propertyValue>
94+
</brandingSetProperty>
95+
<brandingSetProperty>
96+
<propertyName>OverlayTextColor</propertyName>
97+
<propertyValue>rgb(0, 27, 255)</propertyValue>
98+
</brandingSetProperty>
99+
<brandingSetProperty>
100+
<propertyName>PrimaryFont</propertyName>
101+
<propertyValue>Ek Mukta</propertyValue>
102+
</brandingSetProperty>
103+
<brandingSetProperty>
104+
<propertyName>LinkColor</propertyName>
105+
<propertyValue>#3558D6</propertyValue>
106+
</brandingSetProperty>
107+
<masterLabel>USWDS_Lightning_Community</masterLabel>
108+
<type>cpt:branding-cpt</type>
109+
</BrandingSet>

‎src/communityThemeDefinitions/USWDS_Lightning_Community.communityThemeDefinition‎

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
<?xml version="1.0" encoding="UTF-8"?>
2+
<CommunityThemeDefinition xmlns="http://soap.sforce.com/2006/04/metadata">
3+
<bundlesInfo>
4+
<description>Header section allows for OOTB Salesforce Nav, User Profile, and Search as well as custom overrides for each.</description>
5+
<order>1</order>
6+
<title>Dynamic Header</title>
7+
<type>Highlight</type>
8+
</bundlesInfo>
9+
<bundlesInfo>
10+
<description>Builds off mobile styling from US Web Design System and provides users a mobile first experience.</description>
11+
<order>2</order>
12+
<title>Mobile Ready</title>
13+
<type>Highlight</type>
14+
</bundlesInfo>
15+
<bundlesInfo>
16+
<description>Base theme and components tested for 508 compliance and meets WCAG AA standard.</description>
17+
<order>3</order>
18+
<title>508 Compliant</title>
19+
<type>Highlight</type>
20+
</bundlesInfo>
21+
<bundlesInfo>
22+
<image>siteAsset_73208940f50844eb9e9d529e49f3b79a</image>
23+
<order>1</order>
24+
<title>siteAsset_73208940f50844eb9e9d529e49f3b79a</title>
25+
<type>PreviewImage</type>
26+
</bundlesInfo>
27+
<bundlesInfo>
28+
<image>siteAsset_6defa8943c1147a29c8eb9a3ff4cbc4e</image>
29+
<order>2</order>
30+
<title>siteAsset_6defa8943c1147a29c8eb9a3ff4cbc4e</title>
31+
<type>PreviewImage</type>
32+
</bundlesInfo>
33+
<defaultBrandingSet>USWDS_Lightning_Community</defaultBrandingSet>
34+
<description>A US Web Design System Theme for Lightning Communities. https://designsystem.digital.gov/</description>
35+
<enableExtendedCleanUpOnDelete>true</enableExtendedCleanUpOnDelete>
36+
<masterLabel>USWDS Lightning Community</masterLabel>
37+
<publisher>U.S. GSA</publisher>
38+
<themeSetting>
39+
<themeLayout>USWDS_Lightning_Community_themeLayout_Login</themeLayout>
40+
<themeLayoutType>Login</themeLayoutType>
41+
</themeSetting>
42+
<themeSetting>
43+
<themeLayout>USWDS_Lightning_Community_themeLayout_Default</themeLayout>
44+
<themeLayoutType>Inner</themeLayoutType>
45+
</themeSetting>
46+
</CommunityThemeDefinition>

‎src/contentassets/logo.asset‎

8.41 KB
Binary file not shown.

‎src/contentassets/logo.asset-meta.xml‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
<?xml version="1.0" encoding="UTF-8"?>
2+
<ContentAsset xmlns="http://soap.sforce.com/2006/04/metadata">
3+
<isVisibleByExternalUsers>false</isVisibleByExternalUsers>
4+
<language>en_US</language>
5+
<masterLabel>logo</masterLabel>
6+
<originNetwork>uswds</originNetwork>
7+
<relationships>
8+
<network>
9+
<access>VIEWER</access>
10+
<name>uswds</name>
11+
</network>
12+
<workspace>
13+
<access>INFERRED</access>
14+
<isManagingWorkspace>true</isManagingWorkspace>
15+
<name>sfdc_asset_company_assets</name>
16+
</workspace>
17+
</relationships>
18+
<versions>
19+
<version>
20+
<number>1</number>
21+
<pathOnClient>logo.png</pathOnClient>
22+
</version>
23+
</versions>
24+
</ContentAsset>

0 commit comments

Comments
 (0)