Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add a 'View Site' link in the site editor #42331

Merged
merged 12 commits into from
Jul 28, 2022
Merged

Conversation

jameskoster
Copy link
Contributor

@jameskoster jameskoster commented Jul 11, 2022

What?

Add a link from the site editor to view the site.

Why?

Because it is currently not within easy reach.

How?

Added a new MenuItem to PreviewOptions in edit-site/components/header.

As a part of this update I've changed 'Preview' to 'View' for a couple of reasons:

  1. There's no way to _pre_view site editor changes yet.
  2. The device view options aren't strictly previews, they are just view modes for the canvas.

Testing Instructions

  1. Open the Site Editor
  2. Click 'View' in the top toolbar
  3. Click 'View Site'
  4. Ensure the site homepage is opened in a new tab

Screenshots or screencast

view.site.mp4

@jameskoster jameskoster added the [Feature] Site Editor Related to the overarching Site Editor (formerly "full site editing") label Jul 11, 2022
@jameskoster jameskoster requested review from carolinan and a team July 11, 2022 14:30
@jameskoster jameskoster linked an issue Jul 11, 2022 that may be closed by this pull request
@github-actions
Copy link

github-actions bot commented Jul 11, 2022

Size Change: +57 B (0%)

Total Size: 1.26 MB

Filename Size Change
build/block-editor/index.min.js 153 kB -1 B (0%)
build/edit-site/index.min.js 55 kB +58 B (0%)
ℹ️ View Unchanged
Filename Size
build/a11y/index.min.js 982 B
build/annotations/index.min.js 2.76 kB
build/api-fetch/index.min.js 2.26 kB
build/autop/index.min.js 2.14 kB
build/blob/index.min.js 475 B
build/block-directory/index.min.js 6.58 kB
build/block-directory/style-rtl.css 990 B
build/block-directory/style.css 991 B
build/block-editor/default-editor-styles-rtl.css 378 B
build/block-editor/default-editor-styles.css 378 B
build/block-editor/style-rtl.css 14.6 kB
build/block-editor/style.css 14.6 kB
build/block-library/blocks/archives/editor-rtl.css 61 B
build/block-library/blocks/archives/editor.css 60 B
build/block-library/blocks/archives/style-rtl.css 65 B
build/block-library/blocks/archives/style.css 65 B
build/block-library/blocks/audio/editor-rtl.css 150 B
build/block-library/blocks/audio/editor.css 150 B
build/block-library/blocks/audio/style-rtl.css 103 B
build/block-library/blocks/audio/style.css 103 B
build/block-library/blocks/audio/theme-rtl.css 110 B
build/block-library/blocks/audio/theme.css 110 B
build/block-library/blocks/avatar/editor-rtl.css 116 B
build/block-library/blocks/avatar/editor.css 116 B
build/block-library/blocks/avatar/style-rtl.css 59 B
build/block-library/blocks/avatar/style.css 59 B
build/block-library/blocks/block/editor-rtl.css 161 B
build/block-library/blocks/block/editor.css 161 B
build/block-library/blocks/button/editor-rtl.css 441 B
build/block-library/blocks/button/editor.css 441 B
build/block-library/blocks/button/style-rtl.css 542 B
build/block-library/blocks/button/style.css 542 B
build/block-library/blocks/buttons/editor-rtl.css 292 B
build/block-library/blocks/buttons/editor.css 292 B
build/block-library/blocks/buttons/style-rtl.css 275 B
build/block-library/blocks/buttons/style.css 275 B
build/block-library/blocks/calendar/style-rtl.css 207 B
build/block-library/blocks/calendar/style.css 207 B
build/block-library/blocks/categories/editor-rtl.css 84 B
build/block-library/blocks/categories/editor.css 83 B
build/block-library/blocks/categories/style-rtl.css 79 B
build/block-library/blocks/categories/style.css 79 B
build/block-library/blocks/code/style-rtl.css 103 B
build/block-library/blocks/code/style.css 103 B
build/block-library/blocks/code/theme-rtl.css 124 B
build/block-library/blocks/code/theme.css 124 B
build/block-library/blocks/columns/editor-rtl.css 108 B
build/block-library/blocks/columns/editor.css 108 B
build/block-library/blocks/columns/style-rtl.css 406 B
build/block-library/blocks/columns/style.css 406 B
build/block-library/blocks/comment-author-avatar/editor-rtl.css 125 B
build/block-library/blocks/comment-author-avatar/editor.css 125 B
build/block-library/blocks/comment-content/style-rtl.css 92 B
build/block-library/blocks/comment-content/style.css 92 B
build/block-library/blocks/comment-template/style-rtl.css 187 B
build/block-library/blocks/comment-template/style.css 185 B
build/block-library/blocks/comments-pagination-numbers/editor-rtl.css 123 B
build/block-library/blocks/comments-pagination-numbers/editor.css 121 B
build/block-library/blocks/comments-pagination/editor-rtl.css 222 B
build/block-library/blocks/comments-pagination/editor.css 209 B
build/block-library/blocks/comments-pagination/style-rtl.css 235 B
build/block-library/blocks/comments-pagination/style.css 231 B
build/block-library/blocks/comments-title/editor-rtl.css 75 B
build/block-library/blocks/comments-title/editor.css 75 B
build/block-library/blocks/comments/editor-rtl.css 834 B
build/block-library/blocks/comments/editor.css 832 B
build/block-library/blocks/comments/style-rtl.css 632 B
build/block-library/blocks/comments/style.css 630 B
build/block-library/blocks/cover/editor-rtl.css 615 B
build/block-library/blocks/cover/editor.css 616 B
build/block-library/blocks/cover/style-rtl.css 1.55 kB
build/block-library/blocks/cover/style.css 1.55 kB
build/block-library/blocks/embed/editor-rtl.css 293 B
build/block-library/blocks/embed/editor.css 293 B
build/block-library/blocks/embed/style-rtl.css 410 B
build/block-library/blocks/embed/style.css 410 B
build/block-library/blocks/embed/theme-rtl.css 110 B
build/block-library/blocks/embed/theme.css 110 B
build/block-library/blocks/file/editor-rtl.css 300 B
build/block-library/blocks/file/editor.css 300 B
build/block-library/blocks/file/style-rtl.css 253 B
build/block-library/blocks/file/style.css 254 B
build/block-library/blocks/file/view.min.js 346 B
build/block-library/blocks/freeform/editor-rtl.css 2.44 kB
build/block-library/blocks/freeform/editor.css 2.44 kB
build/block-library/blocks/gallery/editor-rtl.css 948 B
build/block-library/blocks/gallery/editor.css 950 B
build/block-library/blocks/gallery/style-rtl.css 1.53 kB
build/block-library/blocks/gallery/style.css 1.53 kB
build/block-library/blocks/gallery/theme-rtl.css 108 B
build/block-library/blocks/gallery/theme.css 108 B
build/block-library/blocks/group/editor-rtl.css 333 B
build/block-library/blocks/group/editor.css 333 B
build/block-library/blocks/group/style-rtl.css 57 B
build/block-library/blocks/group/style.css 57 B
build/block-library/blocks/group/theme-rtl.css 78 B
build/block-library/blocks/group/theme.css 78 B
build/block-library/blocks/heading/style-rtl.css 76 B
build/block-library/blocks/heading/style.css 76 B
build/block-library/blocks/html/editor-rtl.css 327 B
build/block-library/blocks/html/editor.css 329 B
build/block-library/blocks/image/editor-rtl.css 736 B
build/block-library/blocks/image/editor.css 737 B
build/block-library/blocks/image/style-rtl.css 627 B
build/block-library/blocks/image/style.css 630 B
build/block-library/blocks/image/theme-rtl.css 110 B
build/block-library/blocks/image/theme.css 110 B
build/block-library/blocks/latest-comments/style-rtl.css 284 B
build/block-library/blocks/latest-comments/style.css 284 B
build/block-library/blocks/latest-posts/editor-rtl.css 199 B
build/block-library/blocks/latest-posts/editor.css 198 B
build/block-library/blocks/latest-posts/style-rtl.css 463 B
build/block-library/blocks/latest-posts/style.css 462 B
build/block-library/blocks/list/style-rtl.css 88 B
build/block-library/blocks/list/style.css 88 B
build/block-library/blocks/media-text/editor-rtl.css 266 B
build/block-library/blocks/media-text/editor.css 263 B
build/block-library/blocks/media-text/style-rtl.css 493 B
build/block-library/blocks/media-text/style.css 490 B
build/block-library/blocks/more/editor-rtl.css 431 B
build/block-library/blocks/more/editor.css 431 B
build/block-library/blocks/navigation-link/editor-rtl.css 705 B
build/block-library/blocks/navigation-link/editor.css 703 B
build/block-library/blocks/navigation-link/style-rtl.css 115 B
build/block-library/blocks/navigation-link/style.css 115 B
build/block-library/blocks/navigation-submenu/editor-rtl.css 296 B
build/block-library/blocks/navigation-submenu/editor.css 295 B
build/block-library/blocks/navigation-submenu/view.min.js 423 B
build/block-library/blocks/navigation/editor-rtl.css 2.03 kB
build/block-library/blocks/navigation/editor.css 2.04 kB
build/block-library/blocks/navigation/style-rtl.css 1.96 kB
build/block-library/blocks/navigation/style.css 1.95 kB
build/block-library/blocks/navigation/view-modal.min.js 2.78 kB
build/block-library/blocks/navigation/view.min.js 443 B
build/block-library/blocks/nextpage/editor-rtl.css 395 B
build/block-library/blocks/nextpage/editor.css 395 B
build/block-library/blocks/page-list/editor-rtl.css 363 B
build/block-library/blocks/page-list/editor.css 363 B
build/block-library/blocks/page-list/style-rtl.css 175 B
build/block-library/blocks/page-list/style.css 175 B
build/block-library/blocks/paragraph/editor-rtl.css 157 B
build/block-library/blocks/paragraph/editor.css 157 B
build/block-library/blocks/paragraph/style-rtl.css 260 B
build/block-library/blocks/paragraph/style.css 260 B
build/block-library/blocks/post-author/style-rtl.css 175 B
build/block-library/blocks/post-author/style.css 176 B
build/block-library/blocks/post-comments-form/editor-rtl.css 96 B
build/block-library/blocks/post-comments-form/editor.css 96 B
build/block-library/blocks/post-comments-form/style-rtl.css 493 B
build/block-library/blocks/post-comments-form/style.css 493 B
build/block-library/blocks/post-excerpt/editor-rtl.css 73 B
build/block-library/blocks/post-excerpt/editor.css 73 B
build/block-library/blocks/post-excerpt/style-rtl.css 69 B
build/block-library/blocks/post-excerpt/style.css 69 B
build/block-library/blocks/post-featured-image/editor-rtl.css 605 B
build/block-library/blocks/post-featured-image/editor.css 605 B
build/block-library/blocks/post-featured-image/style-rtl.css 153 B
build/block-library/blocks/post-featured-image/style.css 153 B
build/block-library/blocks/post-template/editor-rtl.css 99 B
build/block-library/blocks/post-template/editor.css 98 B
build/block-library/blocks/post-template/style-rtl.css 282 B
build/block-library/blocks/post-template/style.css 282 B
build/block-library/blocks/post-terms/style-rtl.css 73 B
build/block-library/blocks/post-terms/style.css 73 B
build/block-library/blocks/post-title/style-rtl.css 80 B
build/block-library/blocks/post-title/style.css 80 B
build/block-library/blocks/preformatted/style-rtl.css 103 B
build/block-library/blocks/preformatted/style.css 103 B
build/block-library/blocks/pullquote/editor-rtl.css 198 B
build/block-library/blocks/pullquote/editor.css 198 B
build/block-library/blocks/pullquote/style-rtl.css 370 B
build/block-library/blocks/pullquote/style.css 370 B
build/block-library/blocks/pullquote/theme-rtl.css 167 B
build/block-library/blocks/pullquote/theme.css 167 B
build/block-library/blocks/query-pagination-numbers/editor-rtl.css 122 B
build/block-library/blocks/query-pagination-numbers/editor.css 121 B
build/block-library/blocks/query-pagination/editor-rtl.css 221 B
build/block-library/blocks/query-pagination/editor.css 211 B
build/block-library/blocks/query-pagination/style-rtl.css 234 B
build/block-library/blocks/query-pagination/style.css 231 B
build/block-library/blocks/query/editor-rtl.css 365 B
build/block-library/blocks/query/editor.css 364 B
build/block-library/blocks/quote/style-rtl.css 213 B
build/block-library/blocks/quote/style.css 213 B
build/block-library/blocks/quote/theme-rtl.css 223 B
build/block-library/blocks/quote/theme.css 226 B
build/block-library/blocks/read-more/style-rtl.css 132 B
build/block-library/blocks/read-more/style.css 132 B
build/block-library/blocks/rss/editor-rtl.css 202 B
build/block-library/blocks/rss/editor.css 204 B
build/block-library/blocks/rss/style-rtl.css 289 B
build/block-library/blocks/rss/style.css 288 B
build/block-library/blocks/search/editor-rtl.css 165 B
build/block-library/blocks/search/editor.css 165 B
build/block-library/blocks/search/style-rtl.css 385 B
build/block-library/blocks/search/style.css 386 B
build/block-library/blocks/search/theme-rtl.css 114 B
build/block-library/blocks/search/theme.css 114 B
build/block-library/blocks/separator/editor-rtl.css 146 B
build/block-library/blocks/separator/editor.css 146 B
build/block-library/blocks/separator/style-rtl.css 233 B
build/block-library/blocks/separator/style.css 233 B
build/block-library/blocks/separator/theme-rtl.css 194 B
build/block-library/blocks/separator/theme.css 194 B
build/block-library/blocks/shortcode/editor-rtl.css 464 B
build/block-library/blocks/shortcode/editor.css 464 B
build/block-library/blocks/site-logo/editor-rtl.css 708 B
build/block-library/blocks/site-logo/editor.css 708 B
build/block-library/blocks/site-logo/style-rtl.css 192 B
build/block-library/blocks/site-logo/style.css 192 B
build/block-library/blocks/site-tagline/editor-rtl.css 86 B
build/block-library/blocks/site-tagline/editor.css 86 B
build/block-library/blocks/site-title/editor-rtl.css 84 B
build/block-library/blocks/site-title/editor.css 84 B
build/block-library/blocks/social-link/editor-rtl.css 184 B
build/block-library/blocks/social-link/editor.css 184 B
build/block-library/blocks/social-links/editor-rtl.css 674 B
build/block-library/blocks/social-links/editor.css 673 B
build/block-library/blocks/social-links/style-rtl.css 1.39 kB
build/block-library/blocks/social-links/style.css 1.38 kB
build/block-library/blocks/spacer/editor-rtl.css 322 B
build/block-library/blocks/spacer/editor.css 322 B
build/block-library/blocks/spacer/style-rtl.css 48 B
build/block-library/blocks/spacer/style.css 48 B
build/block-library/blocks/table/editor-rtl.css 494 B
build/block-library/blocks/table/editor.css 494 B
build/block-library/blocks/table/style-rtl.css 611 B
build/block-library/blocks/table/style.css 609 B
build/block-library/blocks/table/theme-rtl.css 175 B
build/block-library/blocks/table/theme.css 175 B
build/block-library/blocks/tag-cloud/style-rtl.css 226 B
build/block-library/blocks/tag-cloud/style.css 227 B
build/block-library/blocks/template-part/editor-rtl.css 235 B
build/block-library/blocks/template-part/editor.css 235 B
build/block-library/blocks/template-part/theme-rtl.css 101 B
build/block-library/blocks/template-part/theme.css 101 B
build/block-library/blocks/text-columns/editor-rtl.css 95 B
build/block-library/blocks/text-columns/editor.css 95 B
build/block-library/blocks/text-columns/style-rtl.css 166 B
build/block-library/blocks/text-columns/style.css 166 B
build/block-library/blocks/verse/style-rtl.css 87 B
build/block-library/blocks/verse/style.css 87 B
build/block-library/blocks/video/editor-rtl.css 561 B
build/block-library/blocks/video/editor.css 563 B
build/block-library/blocks/video/style-rtl.css 159 B
build/block-library/blocks/video/style.css 159 B
build/block-library/blocks/video/theme-rtl.css 110 B
build/block-library/blocks/video/theme.css 110 B
build/block-library/common-rtl.css 1.01 kB
build/block-library/common.css 1 kB
build/block-library/editor-elements-rtl.css 75 B
build/block-library/editor-elements.css 75 B
build/block-library/editor-rtl.css 10.9 kB
build/block-library/editor.css 10.9 kB
build/block-library/elements-rtl.css 54 B
build/block-library/elements.css 54 B
build/block-library/index.min.js 184 kB
build/block-library/reset-rtl.css 478 B
build/block-library/reset.css 478 B
build/block-library/style-rtl.css 11.8 kB
build/block-library/style.css 11.8 kB
build/block-library/theme-rtl.css 695 B
build/block-library/theme.css 700 B
build/block-serialization-default-parser/index.min.js 1.11 kB
build/block-serialization-spec-parser/index.min.js 2.83 kB
build/blocks/index.min.js 47.2 kB
build/components/index.min.js 230 kB
build/components/style-rtl.css 14 kB
build/components/style.css 14 kB
build/compose/index.min.js 11.7 kB
build/core-data/index.min.js 14.7 kB
build/customize-widgets/index.min.js 11.2 kB
build/customize-widgets/style-rtl.css 1.4 kB
build/customize-widgets/style.css 1.4 kB
build/data-controls/index.min.js 653 B
build/data/index.min.js 7.99 kB
build/date/index.min.js 32 kB
build/deprecated/index.min.js 507 B
build/dom-ready/index.min.js 324 B
build/dom/index.min.js 4.69 kB
build/edit-navigation/index.min.js 16 kB
build/edit-navigation/style-rtl.css 4.02 kB
build/edit-navigation/style.css 4.03 kB
build/edit-post/classic-rtl.css 546 B
build/edit-post/classic.css 547 B
build/edit-post/index.min.js 30.5 kB
build/edit-post/style-rtl.css 6.94 kB
build/edit-post/style.css 6.94 kB
build/edit-site/style-rtl.css 8.21 kB
build/edit-site/style.css 8.19 kB
build/edit-widgets/index.min.js 16.5 kB
build/edit-widgets/style-rtl.css 4.35 kB
build/edit-widgets/style.css 4.35 kB
build/editor/index.min.js 41.3 kB
build/editor/style-rtl.css 3.66 kB
build/editor/style.css 3.65 kB
build/element/index.min.js 4.27 kB
build/escape-html/index.min.js 537 B
build/format-library/index.min.js 6.75 kB
build/format-library/style-rtl.css 571 B
build/format-library/style.css 571 B
build/hooks/index.min.js 1.64 kB
build/html-entities/index.min.js 448 B
build/i18n/index.min.js 3.77 kB
build/is-shallow-equal/index.min.js 527 B
build/keyboard-shortcuts/index.min.js 1.78 kB
build/keycodes/index.min.js 1.39 kB
build/list-reusable-blocks/index.min.js 1.74 kB
build/list-reusable-blocks/style-rtl.css 835 B
build/list-reusable-blocks/style.css 835 B
build/media-utils/index.min.js 2.93 kB
build/notices/index.min.js 953 B
build/nux/index.min.js 2.05 kB
build/nux/style-rtl.css 732 B
build/nux/style.css 728 B
build/plugins/index.min.js 1.94 kB
build/preferences-persistence/index.min.js 2.22 kB
build/preferences/index.min.js 1.3 kB
build/primitives/index.min.js 933 B
build/priority-queue/index.min.js 612 B
build/react-i18n/index.min.js 696 B
build/react-refresh-entry/index.min.js 8.44 kB
build/react-refresh-runtime/index.min.js 7.31 kB
build/redux-routine/index.min.js 2.68 kB
build/reusable-blocks/index.min.js 2.22 kB
build/reusable-blocks/style-rtl.css 256 B
build/reusable-blocks/style.css 256 B
build/rich-text/index.min.js 11.1 kB
build/server-side-render/index.min.js 1.61 kB
build/shortcode/index.min.js 1.53 kB
build/token-list/index.min.js 644 B
build/url/index.min.js 3.61 kB
build/vendors/react-dom.min.js 38.5 kB
build/vendors/react.min.js 4.34 kB
build/viewport/index.min.js 1.08 kB
build/warning/index.min.js 268 B
build/widgets/index.min.js 7.19 kB
build/widgets/style-rtl.css 1.16 kB
build/widgets/style.css 1.16 kB
build/wordcount/index.min.js 1.06 kB

compressed-size-action

@javierarce
Copy link
Contributor

I love this improvement.

I just saw one thing:

In the post editor this produces the following redundancy:

Screenshot 2022-07-11 at 17 55 34

@jameskoster
Copy link
Contributor Author

Oops 😅

I'll fix that when I get a moment.

@jameskoster
Copy link
Contributor Author

OK I changed the implementation a bit so that the 'View Site' link only appears in the site editor.

Updating the button label to 'View' in the Site Editor makes sense, I'm not 100% sure about the post editor though. There's value in consistency, and I maintain the viewpoint that the device switchers aren't strictly just previews, but the post editor does include a dedicated preview link. What do you think?

@paaljoachim
Copy link
Contributor

Thank you James!!

This looks really good! I have been looking forward to seeing a View page drop down in FSE for quite a while.
Regarding wording...
Instead of a "Preview in new tab" we have the "View Site" (which I find more direct) and the icon which gives the signal that it opens in a new tab.

Should another PR change the wording in a page and post?
As in "View page/Page" and "View post/Post"

@annezazu
Copy link
Contributor

annezazu commented Jul 16, 2022

Just noting that this came up as something that would be welcomed in the FSE Outreach Program's fifteenth call for testing:

Another thing that feels a bit bumpy is when saving the template, there’s no way to quickly access your site again. You have to manually create a new tab, write the URL and select the post/page/archive you were on. This may be a bit hard for specific archive templates but when implementing what I mentioned in the last paragraph, a referral URL could be stored inside Gutenberg as well, so that a link to the page the user was just on could be generated. Just like you have the “View post/page” links you have in the notifications that appear after saving a post or page.

In this case, the view site would happen post save flow, which to me is the best of both worlds since it helps avoid the confusion that might come from making changes, viewing site, and not seeing those changes there.

@jameskoster jameskoster requested review from a team and fluiddot and removed request for a team July 18, 2022 09:35
@talldan
Copy link
Contributor

talldan commented Jul 18, 2022

Should another PR change the wording in a page and post?
As in "View page/Page" and "View post/Post"

@paaljoachim There's a subtle difference in that the post editor preview will show unpublished changes, so it slightly different to just viewing the post. That may be a reason not to change the wording.

@paaljoachim
Copy link
Contributor

Thanks for the reply, @talldan

We could perhaps do a "Preview Post" / "Preview Page" and cut out the "in new tab" part in the drop down of posts and pages.
This is though a sidetrack to this PR though.

@talldan
Copy link
Contributor

talldan commented Jul 18, 2022

Similar to the quote in Anne's comment, I was also wondering if this is the right thing to show when editing say 'Archive' or 'Search', but when I tested I realised it's still quite useful and doesn't feel out of place. I imagine it's quite difficult to include a link directly to the relevant part of the website based on the template being edited.

I also wondered if the label could be something like 'View homepage'?

It also looks like the linting check has failed, this file needs to be formatted - packages/edit-site/src/components/header/index.js (npm run format -- packages/edit-site/src/components/header/index.js should do the trick).

@talldan
Copy link
Contributor

talldan commented Jul 18, 2022

We could perhaps do a "Preview Post" / "Preview Page" and cut out the "in new tab" part in the drop down of posts and pages.

True, that could be simplified. Usually there's some hidden text for screen readers that says 'Opens in a new tab', so it doesn't necessarily have to be visible.

That reminds me, that hidden text should be added in this PR too.

@jameskoster That would involve using the VisuallyHidden component like this menu item does:

<MenuItem
role="menuitem"
icon={ external }
href={ __(
'https://wordpress.org/support/article/block-based-widgets-editor/'
) }
target="_blank"
rel="noopener noreferrer"
>
{ __( 'Help' ) }
<VisuallyHidden as="span">
{
/* translators: accessibility text */
__( '(opens in a new tab)' )
}
</VisuallyHidden>
</MenuItem>

@jameskoster
Copy link
Contributor Author

It might be a nice enhancement to explore template-specific 'view' links, but I suspect the logic could get a bit gnarly. Something to explore later methinks :)

I find 'View Site' and 'View Homepage' to essentially be the same thing, but happy to change if there are strong feelings either way.

@paaljoachim
Copy link
Contributor

paaljoachim commented Jul 18, 2022

"View Site" the meaning I get is that site is really anywhere on the web site.
"View Homepage" for me means viewing the front page. As I have on occasion a link called "Home" which takes one back to the front page.

It is better to keep "View Site" as one would be viewing really any template one has active at the time. Be it an author/category/comments/404 or any other template. As one would modify a template in the site editor and just view the frontend of what the template looks like.

@talldan
Copy link
Contributor

talldan commented Jul 19, 2022

It is better to keep "View Site" as one would be viewing really any template one has active at the time.

The link does always takes you to the homepage, as discussed above it won't take you to the template being edited.

@paaljoachim
Copy link
Contributor

paaljoachim commented Jul 19, 2022

The link does always takes you to the homepage, as discussed above it won't take you to the template being edited.

I have not yet found that discussion.
Is there a way that we can click "View Site" and it will open the current active template? As it would be very helpful if we could actually view a template that is being worked on. Rather than later on having to figure out how to view a specific template on the frontend.

As from (pre)viewing a post or page. It opens the actual post/page and not the homepage. So that we are used to seeing the current selected post/page on the frontend and transferring this over to the site editor would also very much help. (Example the various call for testings @annezazu usually adds a how to view the current template on the frontend step by adding an URL directly to the template.) If that is not possible or hard to do at present time, then having a step between would be helpful. As in opening the homepage by clicking "View Site".

@jameskoster
Copy link
Contributor Author

Is there a way that we can click "View Site" and it will open the current active template?

For me, the concept of 'viewing a template on the frontend' doesn't really make sense, and can quickly break down. As an example, what would happen if you tried to 'view' a template that isn't actually in use anywhere at the site? The idea of 'viewing' is content-centric, IE you view a post, a page, a category, etc. I'm not sure we should cross those streams.

When the site editing experience is also more content-centric (IE once browse mode is implemented) it will make more sense to have contextual view links.

@paaljoachim
Copy link
Contributor

paaljoachim commented Jul 19, 2022

Good point James! That crossed in the back of my mind. I was thinking that for some/many templates these could be viewed on the frontend. Browse mode will be helpful and solve the issue of viewing the template as it is seen on the frontend.

@jameskoster jameskoster linked an issue Jul 20, 2022 that may be closed by this pull request
@richtabor
Copy link
Member

Nice! Very welcome change. Tested it out and works as expected.

One question, should it be View site instead? We use "Edit site" for the Admin bar, and "Visit Site" elsewhere; just want to see if there's opportunity for bringing these closer.

CleanShot 2022-07-21 at 15 43 05@2x

CleanShot 2022-07-21 at 15 44 21@2x

Copy link
Contributor

@talldan talldan left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks good and I think will be a really useful option. It could be a lower case 's' for 'site'. I often forget the rules around this, but I think most of the UI leans towards sentence case.

Some code formatting needs to be done before this can be merged. I think npm run format -- packages/edit-site/src/components/header/index.js is the command that'll sort that out.

@jameskoster
Copy link
Contributor Author

Since 'site' is referring to a specific website, doesn't that make it a proper noun and therefore suitable to capitalisation? I am not a grammar expert either :D

@paaljoachim
Copy link
Contributor

We should stick to sentence case as we usually do.
So "View site" would be correct. Grammer well..... It reminds me. We should change "List View" to "List view".....

@jameskoster
Copy link
Contributor Author

Wouldn't nouns over-rule the case convention? 🤔

@talldan
Copy link
Contributor

talldan commented Jul 26, 2022

Wouldn't nouns over-rule the case convention?

I refreshed my grammar skills, and came to the conclusion that I don't think I'd consider it a proper noun. If the button said the name of the site (e.g. 'View Making WordPress'), then I think it would be capitalised, but 'site' is a common noun for a website and should be lower case in a sentence.

I think a similar sentence would be something like "Exit the building" (common noun, so building is lower case) vs "Exit the Empire State Building" (proper noun. so the name of the building is upper case).

BTW, there are e2e tests that are failing and need updating because the test still expects the old name of the button (Preview instead of View) in the post editor. Are you happy to update those @jameskoster? If not, let me know and I'd be happy to add a commit to the branch.

@jameskoster
Copy link
Contributor Author

@talldan what's the command to update the tests? 🙏

@talldan
Copy link
Contributor

talldan commented Jul 27, 2022

@talldan what's the command to update the tests?

It's a manual process of going through the failing tests and updating the selectors used to interact with the preview button.

@jameskoster
Copy link
Contributor Author

Hopefully I did it correctly... let's see! 🙈

@talldan
Copy link
Contributor

talldan commented Jul 28, 2022

Looks spot on! There's a code formatting issue again to resolve in packages/e2e-test-utils-playwright/src/editor/preview.ts, but once that's sorted you should be able to merge.

@tomjn
Copy link
Contributor

tomjn commented Oct 6, 2022

Noting that this didn't just change the preview button in the site editor, it changed it in all editors, including the post editor

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
[Feature] Site Editor Related to the overarching Site Editor (formerly "full site editing") Needs User Documentation Needs new user documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Site Editor: Add a link to view the site Accessing the front-end from the site editor
8 participants