Skip to content

Commit 7f208ab

Browse files
Update navigation with dashbutton (#25646)
* Update navigation with dashbutton * Apply suggestions from code review Co-authored-by: ToriLindsay <[email protected]> --------- Co-authored-by: ToriLindsay <[email protected]>
1 parent c1a4c1b commit 7f208ab

File tree

21 files changed

+178
-124
lines changed

21 files changed

+178
-124
lines changed

src/content/docs/analytics/account-and-zone-analytics/zone-analytics.mdx

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ sidebar:
77

88
---
99

10-
import { Badge } from "~/components";
10+
import { Badge, DashButton } from "~/components";
1111

1212

1313
The Cloudflare zone analytics is a major component of the overall Cloudflare Analytics product line.  Specifically, this app gives you access to a wide range of metrics, collected at the website or domain level.
@@ -24,11 +24,9 @@ captures and processes.
2424

2525
## View your website analytics
2626

27-
To view metrics for your website:
27+
To view metrics for your website, in the Cloudflare dashboard, go to the **Analytis & Logs** page.
2828

29-
1. Log in to the Cloudflare dashboard.
30-
2. Select the appropriate Cloudflare **account** for your site, then pick the **domain**.
31-
3. Next, select **Analytics & Logs**.
29+
<DashButton url="/?to=/:account/:zone/analytics" />
3230

3331
Once it loads, you can find tabs for **Traffic**, **Security**, **Performance**, **DNS**, **Workers**, and **Logs** (Enterprise domains only). To understand the various metrics available, refer to *Review your website metrics* below.
3432

src/content/docs/cache/advanced-configuration/cache-reserve.mdx

Lines changed: 12 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Cache Reserve
33
pcx_content_type: concept
44
---
55

6-
import { Render, TabItem, Tabs, APIRequest } from "~/components";
6+
import { Render, TabItem, Tabs, APIRequest, DashButton } from "~/components";
77

88
<Render file="smart-shield-callout" product="smart-shield" />
99

@@ -25,9 +25,11 @@ A paid Cache Reserve Plan is required for the enablement.
2525

2626
<Tabs syncKey="dashPlusAPI"> <TabItem label="Dashboard">
2727

28-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login) and select a domain.
29-
2. Go to **Caching** > **Cache Reserve**.
30-
3. Select **Enable storage sync**.
28+
1. In the Cloudflare dashboard, go to the **Cache Reserve** page.
29+
30+
<DashButton url="/?to=/:account/:zone/caching/cache-reserve" />
31+
32+
2. Select **Enable storage sync**.
3133

3234
</TabItem> <TabItem label="API">
3335

@@ -165,9 +167,12 @@ Be aware that the deletion may take up to 24 hours to complete.
165167

166168
<Tabs syncKey="dashPlusAPI"> <TabItem label="Dashboard">
167169

168-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login) and select a domain.
169-
2. Go to **Caching** > **Cache Reserve**.
170-
3. In **Delete Cache Reserve Data**, select **Delete Storage**.
170+
171+
1. In the Cloudflare dashboard, go to the **Cache Reserve** page.
172+
173+
<DashButton url="/?to=/:account/:zone/caching/cache-reserve" />
174+
175+
2. In **Delete Cache Reserve Data**, select **Delete Storage**.
171176

172177
</TabItem> <TabItem label="API">
173178

src/content/docs/cache/advanced-configuration/crawler-hints.mdx

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ title: Crawler Hints
44

55
---
66

7-
import { FeatureTable } from "~/components"
7+
import { FeatureTable, DashButton } from "~/components"
88

99
Crawler Hints aims to increase the proportion of relevant crawls and limit crawls that do not find fresh content to reduce the need for repeated crawls.
1010

@@ -26,9 +26,11 @@ Crawler Hints also means less traffic hitting your origin, improving resource co
2626

2727
## Enable Crawler Hints
2828

29-
1. Log in to your [Cloudflare dashboard](https://dash.cloudflare.com) and select your domain.
30-
2. Go to **Caching** > **Configuration**.
31-
3. Enable **Crawler Hints**.
29+
1. In the Cloudflare dashboard, go to the **Configuration** page.
30+
31+
<DashButton url="/?to=/:account/:zone/caching/configuration" />
32+
33+
2. Enable **Crawler Hints**.
3234

3335
After enabling Crawler Hints, Cloudflare will begin sending hints to search engines about when they should crawl particular parts of your website.
3436

src/content/docs/cache/cache-security/cache-deception-armor.mdx

Lines changed: 11 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@ title: Cache Deception Armor
44

55
---
66

7+
import { DashButton } from "~/components";
8+
79
Before learning about Cache Deception Armor, you should first understand how Web Cache Deception attacks work.
810

911
## Web Cache Deception attacks
@@ -30,10 +32,12 @@ In the newsfeed example above, if `http://www.example.com/newsfeed` is a script
3032

3133
To enable Cache Deception Armor, you need to start by creating a [cache rule](/cache/how-to/cache-rules/). Follow the steps below for guidance:
3234

33-
1. Log in to your [Cloudflare dashboard](https://dash.cloudflare.com), and select your account and domain.
34-
2. Go to **Caching** > **Cache Rules**.
35-
3. Select **Create rule**.
36-
4. Under **When incoming requests match**, define the [rule expression](/ruleset-engine/rules-language/expressions/edit-expressions/#expression-builder).
37-
5. Under **Then**, in the **Cache eligibility** section, select **Eligible for cache**.
38-
6. Add the **Cache Key** setting to the rule and turn on **Cache deception armor**.
39-
7. To save and deploy your rule, select **Deploy**. If you are not ready to deploy your rule, select **Save as Draft**.
35+
1. In the Cloudflare dashboard, go to the **Cache Rules** page.
36+
37+
<DashButton url="/?to=/:account/:zone/caching/cache-rules" />
38+
39+
2. Select **Create rule**.
40+
3. Under **When incoming requests match**, define the [rule expression](/ruleset-engine/rules-language/expressions/edit-expressions/#expression-builder).
41+
4. Under **Then**, in the **Cache eligibility** section, select **Eligible for cache**.
42+
5. Add the **Cache Key** setting to the rule and turn on **Cache deception armor**.
43+
6. To save and deploy your rule, select **Deploy**. If you are not ready to deploy your rule, select **Save as Draft**.

src/content/docs/cache/how-to/always-online.mdx

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ pcx_content_type: concept
44

55
---
66

7-
import { FeatureTable } from "~/components"
7+
import { FeatureTable, DashButton } from "~/components"
88

99
Cloudflare’s Always Online feature is now integrated with the [Internet Archive](https://archive.org/) so that visitors can access a portion of your website even when your origin server is unreachable and a Cloudflare-cached version is unavailable. When your origin is unreachable, Always Online checks Cloudflare’s cache for a stale or expired version of your website. If a version does not exist, Cloudflare goes to the Internet Archive to fetch and serve static portions of your website.
1010

@@ -32,10 +32,12 @@ Visitors who interact with dynamic parts of a website, such as a shopping cart o
3232

3333
Here is how to enable Always Online in the dashboard:
3434

35-
1. Log in to your Cloudflare account.
35+
1. In the Cloudflare dashboard, go to the **Configuration** page.
36+
37+
<DashButton url="/?to=/:account/:zone/caching/configuration" />
38+
3639
2. Choose the domain that will use Always Online with Internet Archive integration.
37-
3. Select **Caching** > **Configuration**.
38-
4. Under **Always Online**, set the toggle to **On**.
40+
3. Under **Always Online**, set the toggle to **On**.
3941

4042
:::note[Note]
4143

src/content/docs/cache/how-to/cache-keys.mdx

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ head:
77

88
---
99

10-
import { FeatureTable } from "~/components"
10+
import { FeatureTable, DashButton } from "~/components"
1111

1212
A Cache Key is an identifier that Cloudflare uses for a file in our cache, and the Cache Key Template defines the identifier for a given HTTP request.
1313

@@ -25,14 +25,16 @@ A default cache key includes:
2525

2626
Custom cache keys let you precisely set the cacheability setting for any resource. They provide the benefit of more control, though they may reduce your cache hit rate and result in cache sharding:
2727

28-
1. Log in to your [Cloudflare dashboard](https://dash.cloudflare.com), and select your account and domain.
29-
2. Go to **Caching** > **Cache Rules**.
30-
3. Select **Create rule**.
31-
4. Under **When incoming requests match**, define the [rule expression](/ruleset-engine/rules-language/expressions/edit-expressions/#expression-builder).
32-
5. Under **Then**, in the **Cache eligibility** section, select **Eligible for cache**.
33-
6. Add the **Cache Key** setting to the rule and select the appropriate **Query String** setting.
34-
7. You can also select settings for **Headers**, **Cookie**, **Host**, and **User**.
35-
8. To save and deploy your rule, select **Deploy**. If you are not ready to deploy your rule, select **Save as Draft**.
28+
1. In the Cloudflare dashboard, go to the **Cache Rules** page.
29+
30+
<DashButton url="/?to=/:account/:zone/caching/cache-rules" />
31+
32+
2. Select **Create rule**.
33+
3. Under **When incoming requests match**, define the [rule expression](/ruleset-engine/rules-language/expressions/edit-expressions/#expression-builder).
34+
4. Under **Then**, in the **Cache eligibility** section, select **Eligible for cache**.
35+
5. Add the **Cache Key** setting to the rule and select the appropriate **Query String** setting.
36+
6. You can also select settings for **Headers**, **Cookie**, **Host**, and **User**.
37+
7. To save and deploy your rule, select **Deploy**. If you are not ready to deploy your rule, select **Save as Draft**.
3638

3739
:::note
3840
When [URL normalization](/rules/normalization/) is enabled, we recommend also enabling [Normalize URLs to origin](/rules/normalization/manage/), especially if you are setting custom cache keys or using cache by device type, which also modifies the cache key. This helps ensure the URL in the cache key matches the URL sent to the origin, preventing cache poisoning and ensuring consistent behavior.

src/content/docs/cache/how-to/cache-rules/create-dashboard.mdx

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -8,15 +8,17 @@ head:
88
content: Create a cache rule in the dashboard
99
---
1010

11-
import { Render } from "~/components";
12-
13-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account and domain.
14-
2. Go to **Rules** > **Overview**.
15-
3. Next to **Cache Rules**, select **Create rule**.
16-
4. (Optional) Select one of the rule templates that address common use cases. Then, review and adjust the proposed rule configuration.
17-
5. Enter a descriptive name for the rule in **Rule name**.
18-
6. Under **When incoming requests match**, select **All incoming requests** if you want the rule to apply to all traffic or **Custom filter expression** if you want the rule to only apply to traffic matching the custom expression.
19-
7. If you selected **Custom filter expression**, under **When incoming requests match**, define the [rule expression](/ruleset-engine/rules-language/expressions/edit-expressions/#expression-builder). Use the **Field** drop-down list to choose an HTTP property and select an **Operator**. Refer to [Available settings](/cache/how-to/cache-rules/settings/) for the list of available fields and operators.
11+
import { Render, DashButton } from "~/components";
12+
13+
1. In the Cloudflare dashboard, go to the **Cache Rules** page.
14+
15+
<DashButton url="/?to=/:account/:zone/caching/cache-rules" />
16+
17+
2. Select **Create rule**.
18+
3. (Optional) Select one of the rule templates that address common use cases. Then, review and adjust the proposed rule configuration.
19+
4. Enter a descriptive name for the rule in **Rule name**.
20+
5. Under **When incoming requests match**, select **All incoming requests** if you want the rule to apply to all traffic or **Custom filter expression** if you want the rule to only apply to traffic matching the custom expression.
21+
6. If you selected **Custom filter expression**, under **When incoming requests match**, define the [rule expression](/ruleset-engine/rules-language/expressions/edit-expressions/#expression-builder). Use the **Field** drop-down list to choose an HTTP property and select an **Operator**. Refer to [Available settings](/cache/how-to/cache-rules/settings/) for the list of available fields and operators.
2022

2123
<div class="medium-img">
2224

src/content/docs/cache/how-to/purge-cache/purge-by-hostname.mdx

Lines changed: 11 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -6,18 +6,22 @@ sidebar:
66

77
---
88

9+
import { DashButton } from "~/components"
10+
911
Purging by hostname means that all assets at URLs with a host that matches one of the provided values will be instantly purged from the cache.
1012

11-
1. Log in to your [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account and domain.
12-
2. Select **Caching** > **Configuration**.
13-
3. Under **Purge Cache**, select **Custom Purge**. The **Custom Purge** window appears.
14-
4. Under **Purge by**, select **Hostname**.
15-
5. Follow the syntax instructions:
13+
1. In the Cloudflare dashboard, go to the **Configuration** page.
14+
15+
<DashButton url="/?to=/:account/:zone/caching/configuration" />
16+
17+
2. Under **Purge Cache**, select **Custom Purge**. The **Custom Purge** window appears.
18+
3. Under **Purge by**, select **Hostname**.
19+
4. Follow the syntax instructions:
1620
* One hostname per line.
1721
* Separated by commas.
1822
* You can purge up to 30 hostnames at a time.
19-
6. Enter the appropriate value(s) in the text field using the format shown in the example.
20-
7. Select **Purge**.
23+
5. Enter the appropriate value(s) in the text field using the format shown in the example.
24+
6. Select **Purge**.
2125

2226
For information on rate limits, refer to the [Availability and limits](/cache/how-to/purge-cache/#availability-and-limits) section.
2327

src/content/docs/cache/how-to/purge-cache/purge-by-single-file.mdx

Lines changed: 12 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,8 @@ sidebar:
55
order: 1
66
---
77

8+
import { DashButton } from "~/components"
9+
810
With purge by single-file, cached resources are instantly removed from the stored assets in your Content Delivery Network (CDN) across all data centers. New requests for the purged asset receive the latest version from your origin web server and add it back to your CDN cache within the specific Cloudflare data center that served the request.
911

1012
For information on single-file purge rate limits, refer to the [limits](/cache/how-to/purge-cache/#single-file-purge-limits) section.
@@ -27,14 +29,16 @@ You can purge objects with these characteristics using an API call to ([purge fi
2729
Always use UTF-8 encoded URLs for single-file cache purges. Wildcards are not supported on single file purge, and you must use purge by hostname, prefix, or implement cache tags as an alternative solution.
2830
:::
2931

30-
1. Log in to your [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account and domain.
31-
2. Select **Caching** > **Configuration**.
32-
3. Under **Purge Cache**, select **Custom Purge**. The **Custom Purge** window appears.
33-
4. Under **Purge by**, select **URL**.
34-
5. Enter the appropriate value(s) in the text field using the format shown in the example. Be aware that the host part of the URL is not case-sensitive, meaning it will always be converted to lowercase according to RFC standards. However, the path portion is case-sensitive. For example, `https://EXAMPLE.com/helloHI` would be treated as `https://example.com/helloHI`.
35-
6. Perform any additional instructions to complete the form.
36-
7. Review your entries.
37-
8. Select **Purge**.
32+
1. In the Cloudflare dashboard, go to the **Configuration** page.
33+
34+
<DashButton url="/?to=/:account/:zone/caching/configuration" />
35+
36+
2. Under **Purge Cache**, select **Custom Purge**. The **Custom Purge** window appears.
37+
3. Under **Purge by**, select **URL**.
38+
4. Enter the appropriate value(s) in the text field using the format shown in the example. Be aware that the host part of the URL is not case-sensitive, meaning it will always be converted to lowercase according to RFC standards. However, the path portion is case-sensitive. For example, `https://EXAMPLE.com/helloHI` would be treated as `https://example.com/helloHI`.
39+
5. Perform any additional instructions to complete the form.
40+
6. Review your entries.
41+
7. Select **Purge**.
3842

3943
:::note
4044
For information on how to use single-file purge to purge assets cached by a Workers fetch, refer to [Single file purge assets cached by a Worker](/workers/reference/how-the-cache-works/#single-file-purge-assets-cached-by-a-worker).

src/content/docs/cache/how-to/purge-cache/purge-by-tags.mdx

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,8 @@ sidebar:
66

77
---
88

9+
import { DashButton } from "~/components"
10+
911
Cache-tag purging makes multi-file purging easier because you can instantly bulk purge by adding cache-tags to your assets, such as webpages, image files, and more.
1012

1113
## General workflow for cache-tags
@@ -46,12 +48,14 @@ When your content reaches our edge network, Cloudflare:
4648

4749
## Purge using cache-tags
4850

49-
1. Log in to your [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account and domain.
50-
2. Select **Caching** > **Configuration**.
51-
3. Under **Purge Cache**, select **Custom Purge**. The **Custom Purge** window appears.
52-
4. Under **Purge by**, select **Tag**.
53-
5. In the text box, enter your tags to use to purge the cached resources. To purge multiple cache-tagged resources, separate each tag with a comma or have one tag per line.
54-
6. Select **Purge**.
51+
1. In the Cloudflare dashboard, go to the **Configuration** page.
52+
53+
<DashButton url="/?to=/:account/:zone/caching/configuration" />
54+
55+
2. Under **Purge Cache**, select **Custom Purge**. The **Custom Purge** window appears.
56+
3. Under **Purge by**, select **Tag**.
57+
4. In the text box, enter your tags to use to purge the cached resources. To purge multiple cache-tagged resources, separate each tag with a comma or have one tag per line.
58+
5. Select **Purge**.
5559

5660
For information on rate limits, refer to the [Availability and limits](/cache/how-to/purge-cache/#availability-and-limits) section.
5761

0 commit comments

Comments
 (0)