Make WordPress Core

Opened 2 years ago

Closed 8 months ago

Last modified 3 months ago

#55546 closed enhancement (wontfix)

It is unclear what the two URL settings mean.

Reported by: billpg's profile billpg Owned by:
Milestone: Priority: normal
Severity: normal Version:
Component: Help/About Keywords: 2nd-opinion tooltips
Focuses: ui, accessibility, administration, ui-copy Cc:

Description

There are two settings that accept a URL on the General Settings page: "WordPress Address (URL)" and "Site Address (URL)".

To me, those two labels both mean exactly the same thing. It isn't clear if/when I should configure different values in these fields.

If the two settings do actually mean the same thing, then one should be removed and code looking-up its value should be modified to read the remaining setting instead.

If the two settings serve different purposes, then each one should have a note describing what it is used for and the labels should be changed to reflect those different purposes.

Attachments (2)

2023-03-09_09-19-53.png (16.8 KB) - added by oglekler 13 months ago.
2023-03-12_22-38-56.png (50.4 KB) - added by oglekler 13 months ago.

Download all attachments as: .zip

Change History (15)

#1 @peterwilsoncc
2 years ago

  • Version 5.9.3 deleted

Hi @billpg and welcome to trac!

The settings do server different purposes but, you are correct, the explanation could be clearer.

It's possible for WordPress to be installed at a different address than the home page, most commonly it's in a sub-directory:

WordPress address: example.com/wp
Site address: example.com

In this example, the admin would be at example.com/wp/wp-admin/

Do you have any thoughts on the explanatory text WordPress could add to make this clearer?

#2 follow-up: @billpg
2 years ago

Is "Site Address" to make the post/page permalink URLs, while "WordPress Address" is to construct the "wp-admin", "wp-content", etc URLs?

It would be useful to understand a use-case for keeping those two as separate settings with different values. My own website was in a sub-folder (https://billpg.com/site/) until I found a .htaccess setting to deal with requests that don't have a corresponding file in my public_html folder by silently rewriting URLs into my "site" folder. Before and after that reconfiguration, both URL settings inside WP had the same value as each other. "https://billpg.com/site" before and "https://billpg.com" after.

#3 in reply to: ↑ 2 @peterwilsoncc
2 years ago

Replying to billpg:

Is "Site Address" to make the post/page permalink URLs, while "WordPress Address" is to construct the "wp-admin", "wp-content", etc URLs?

Yes, that is correct.

It would be useful to understand a use-case for keeping those two as separate settings with different values. My own website was in a sub-folder (https://billpg.com/site/) until I found a .htaccess setting to deal with requests that don't have a corresponding file in my public_html folder by silently rewriting URLs into my "site" folder. Before and after that reconfiguration, both URL settings inside WP had the same value as each other. "https://billpg.com/site" before and "https://billpg.com" after.

The use case is that it allows site owners to put three files in the site's root directory (site URL) and refer to the sub-directory directory (WordPress URL). It saves the effort of modifying the .htaccess file to rewrite URLs.

I've set up a gist with the three files in my site's root directory.

#5 @sabernhardt
23 months ago

  • Component changed from Text Changes to Administration
  • Focuses ui-copy added

#6 @SergeyBiryukov
14 months ago

  • Component changed from Administration to Help/About
  • Focuses administration added
  • Keywords 2nd-opinion added

The help text for the WordPress URL and Site URL settings has been improved in [55452] / #50886.

Is that clarification good enough for now? Are any further adjustements needed?

#7 @oglekler
13 months ago

I am suggesting short and clear explanation right on the places where we need them (the mockup is above). We have another ticket with proposal to add tooltips #51006, and I believe that they will help us immensely to make clear but informative design.

This fields still confusing me, because
Site Address (URL) = home_url()
WordPress Address (URL) = site_url()

And with regard to the Help, I am suggesting to make bold subtitles according to settings part it referenced to, to make it easier to navigate/read (the mockup is above as well).

#8 @SergeyBiryukov
13 months ago

  • Focuses accessibility added

Adding the accessibility focus for the tooltips suggested in comment:7.

This ticket was mentioned in Slack in #accessibility by ryokuhi. View the logs.


13 months ago

#10 @joedolson
13 months ago

If we want to add tooltips, we'll just need to land on an implementation for use in core. Related: #51006

#11 @oglekler
11 months ago

  • Keywords tooltips added

#12 @ZaneMatthew
8 months ago

  • Resolution set to wontfix
  • Status changed from new to closed

Theres existing help text providing guidance on the two links, along with a URL that leads to substantial detail regarding the difference (https://wordpress.org/documentation/article/giving-wordpress-its-own-directory/) any additional text/tooltip/etc., would create documentation redundancy forcing us to maintain two areas of explanation. Ticket is marked as resolved.

#13 @swissspidy
3 months ago

  • Milestone Awaiting Review deleted
Note: See TracTickets for help on using tickets.