You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: assemblies/assembly-customizing-the-appearance.adoc
+3-1Lines changed: 3 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,13 +3,15 @@
3
3
[id="{context}"]
4
4
= Customizing {product} appearance
5
5
6
+
By modifying the visual aspects of the interface, organizations can align {product} with their branding guidelines and improve the overall user experience.
7
+
6
8
The following default theme configurations are available for {product}:
7
9
8
10
The {product} theme:: Default theme configurations to make your developer portal look like a standard {product} instance. For more information, see xref:ref-customize-rhdh-default-rhdh_{context}[]
9
11
10
12
The Backstage theme:: Default theme configurations to make your developer portal look like a standard Backstage instance. For more information, see xref:ref-customize-rhdh-default-backstage_{context}[]
11
13
12
-
You can change or disable particular parameters in a default theme or create a fully customized theme by modifying the `app-config-rhdh.yaml` file. From the `app-config-rhdh.yaml` file, you can customize common theme components, including the following:
14
+
You can change or disable particular parameters in a default theme or create a fully customized theme by modifying the `app-config-rhdh.yaml` file. From the `app-config-rhdh.yaml` file, you can customize common theme components, including the following components:
13
15
14
16
* Company name and logo
15
17
* Font color, size, and style of text in paragraphs, headings, headers, and buttons
Copy file name to clipboardExpand all lines: modules/configuring-a-floating-action-button/proc-configuring-floating-action-button-as-a-dynamic-plugin.adoc
+15-19Lines changed: 15 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,7 +13,6 @@ To configure a floating action button as a dynamic plugin, complete any of the f
13
13
14
14
* Specify the `global.floatingactionbutton/config` mount point in your `app-config-dynamic.yaml` file. For example:
15
15
+
16
-
.Example of a bulk-import plugin as a floating action button
@@ -43,12 +42,11 @@ To configure a floating action button as a dynamic plugin, complete any of the f
43
42
icon: bulkImportIcon
44
43
text: Bulk import
45
44
----
46
-
<1> (Required) The import name with an associated component to the mount point.
47
-
<2> Use the `svg` value to display a black BulkImportPage icon.
45
+
`frontend:mountPoints:importName`:: (Required) The import name with an associated component to the mount point.
46
+
`frontend:mountPoints:importName:icon`:: Use the `svg` value to display a black `BulkImportPage` icon.
48
47
49
48
* To configure an action as a floating action button that opens an external link, specify the `global.floatingactionbutton/config` mount point in your `dynamic-plugins.yaml` file within the `backstage-plugin-global-floating-action-button` plugin. For example:
50
49
+
51
-
.Example of a floating action button that opens GitHub
@@ -76,12 +74,11 @@ To configure a floating action button as a dynamic plugin, complete any of the f
76
74
toolTip: 'Github'
77
75
to: https://github.com/redhat-developer/rhdh-plugins
78
76
----
79
-
<1> (Required) The import name with an associated component to the mount point.
80
-
<2> Use the `svg` value to display the `Quay` icon.
77
+
`frontend:mountPoints:importName`:: (Required) The import name with an associated component to the mount point.
78
+
`frontend:mountPoints:importName:icon`:: Use the `svg` value to display the `Quay` icon.
81
79
82
80
* To configure a floating action button that contains a submenu, define the `global.floatingactionbutton/config` mount point in the same `slot` field in your `dynamic-plugins.yaml` file for multiple actions. The default slot is `page-end` when not specified. For example:
83
81
+
84
-
.Example of a floating action button with submenu actions
<1> (Required) The import name with an associated component to the mount point.
136
+
`frontend:mountPoints:importName`:: (Required) The import name with an associated component to the mount point.
140
137
141
138
* To configure a floating action button to display only on specific pages, configure the `global.floatingactionbutton/config` mount point in the `backstage-plugin-global-floating-action-button` plugin and set the `visibleOnPaths` property as shown in the following example:
142
139
+
143
-
.Example of a floating action button to display specific pages
@@ -171,11 +167,10 @@ To configure a floating action button as a dynamic plugin, complete any of the f
171
167
icon: bulkImportIcon
172
168
text: Bulk import
173
169
----
174
-
<1> (Required) The import name with an associated component to the mount point.
170
+
`frontend:mountPoints:importName`:: (Required) The import name with an associated component to the mount point.
175
171
176
172
* To hide a floating action button on specific pages, configure the `global.floatingactionbutton/config` mount point in the `backstage-plugin-global-floating-action-button` plugin and set the `excludeOnPaths` property as shown in the following example:
177
173
+
178
-
.Example of a floating action button to hide specific pages
Copy file name to clipboardExpand all lines: modules/configuring-the-global-header/con-quicklinks-and-starred-items-in-global-header.adoc
+7-11Lines changed: 7 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,8 +7,8 @@ The *Quicklinks* matrix, organized by sections (for example, Documentation or De
7
7
8
8
The default configuration includes the following components:
9
9
10
-
*StarredDropdown*: Displays the *Starred Items* menu in the global header by default, as shown in the following configuration:
11
-
10
+
* *StarredDropdown*: Displays the *Starred Items* menu in the global header by default, as shown in the following configuration:
11
+
+
12
12
[source,yaml]
13
13
----
14
14
# Group: Global Header
@@ -19,8 +19,8 @@ The default configuration includes the following components:
19
19
priority: 85
20
20
----
21
21
22
-
*ApplicationLauncherDropdown*: Provides the *Quicklinks* matrix (application launcher) by default, as shown in the following configuration:
23
-
22
+
* *ApplicationLauncherDropdown*: Provides the *Quicklinks* matrix (application launcher) by default, as shown in the following configuration:
23
+
+
24
24
[source,yaml]
25
25
----
26
26
# Group: Global Header
@@ -31,8 +31,8 @@ The default configuration includes the following components:
31
31
priority: 82
32
32
----
33
33
34
-
*MenuItemLink entries*: Define sections, titles, icons, and links within the *Quicklinks* matrix. The default configuration includes links to the {product-short} documentation and an {product-very-short} Local, as shown in the following configurations:
35
-
34
+
* *MenuItemLink entries*: Define sections, titles, icons, and links within the *Quicklinks* matrix. The default configuration includes links to the {product-short} documentation and an {product-very-short} Local, as shown in the following configurations:
35
+
+
36
36
[source,yaml,subs="+attributes"]
37
37
----
38
38
- mountPoint: global.header/application-launcher
@@ -59,8 +59,4 @@ The default configuration includes the following components:
59
59
[NOTE]
60
60
====
61
61
When upgrading from previous versions, the installer does not overwrite your existing `dynamic-plugins.yaml` configuration. If you had not configured *Starred Items* or *Quicklinks* previously, they remain disabled after the upgrade and must be manually enabled.
. (Optional) If you do not provide `logo` props to the `CompanyLogo` component, the component instead uses values defined under `app.branding` in your `{my-app-config-file}` file. You can configure the `CompanyLogo` as shown in the following configuration:
Copy file name to clipboardExpand all lines: modules/configuring-the-global-header/proc-customize-rhdh-global-header.adoc
+9-9Lines changed: 9 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,20 +4,18 @@
4
4
You can use the `red-hat-developer-hub.backstage-plugin-global-header` dynamic plugin to extend the global header with additional buttons and customize the order and position of icons and features. Additionally, you can create and integrate your custom dynamic header plugins using the mount points provided by this new header feature, allowing you to further tailor to suit your needs.
5
5
For more information about enabling dynamic plugins, see {installing-and-viewing-plugins-book-link}[{installing-and-viewing-plugins-book-title}].
@@ -74,10 +72,12 @@ For more information about enabling dynamic plugins, see {installing-and-viewing
74
72
config:
75
73
priority: 10
76
74
----
77
-
<1> *search*: Hides the *Search* modal in the sidebar menu. Change it to `true` to display the *Search* modal in the sidebar.
78
-
<2> *settings*: Hides the *Settings* button in the sidebar menu. Change it to `true` to display the *Settings* button in the sidebar.
79
-
<3> `default.main-menu-items`: Hides the *Self-service* button from the sidebar menu. Remove this field to display the *Self-service* button in the sidebar.
80
-
<4> *position*: Defines the position of the header. Options: `above-main-content` or `above-sidebar`.
75
+
where:
76
+
77
+
*search*:: Hides the *Search* modal in the sidebar menu. Change it to `true` to display the *Search* modal in the sidebar.
78
+
*settings*:: Hides the *Settings* button in the sidebar menu. Change it to `true` to display the *Settings* button in the sidebar.
79
+
`default.main-menu-items`:: Hides the *Self-service* button from the sidebar menu. Remove this field to display the *Self-service* button in the sidebar.
80
+
*position*:: Defines the position of the header. Options: `above-main-content` or `above-sidebar`.
81
81
82
82
To extend the functionality of the default global header, include any the following attributes in your global header entry:
Copy file name to clipboardExpand all lines: modules/configuring-the-global-header/proc-displaying-preferred-username-in-profile-drop-down.adoc
+6-5Lines changed: 6 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,8 +4,9 @@
4
4
You can display the preferred username in the global header profile drop-down list by configuring `spec.profile.displayName` in the user entity. When not configured, the application falls back to a `metadata.title`. If neither is configured, it defaults to a user-friendly name generated by the `useProfileInfo` hook.
5
5
6
6
.Procedure
7
-
.Example when you configure `spec.profile.displayName`
8
7
8
+
* When you configure `spec.profile.displayName`, use the following code:
9
+
+
9
10
[source,yaml,subs="+attributes,+quotes"]
10
11
----
11
12
apiVersion: backstage.io/v1alpha1
@@ -22,8 +23,8 @@ spec:
22
23
memberOf: [janus-authors]
23
24
----
24
25
25
-
.Example when you do not configure `spec.profile.displayname` but configure `metadata.title`
26
-
26
+
* When you do not configure `spec.profile.displayname` but configure `metadata.title`, use the following code:
27
+
+
27
28
[source,yaml,subs="+attributes,+quotes"]
28
29
----
29
30
apiVersion: backstage.io/v1alpha1
@@ -37,8 +38,8 @@ spec:
37
38
memberOf: [janus-authors]
38
39
----
39
40
40
-
.Example when you do not configure the `spec.profile.displayname` and the `metadata.title`
41
-
41
+
* When you do not configure the `spec.profile.displayname` and the `metadata.title`, use the following code:
0 commit comments