<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head><meta http-equiv="content-type" content="text/html; charset=utf-8" />
<title>[BuddyPress][13719] trunk/docs/user: `docs/user`: update the URLs settings screen documentation</title>
</head>
<body>
<style type="text/css"><!--
#msg dl.meta { border: 1px #006 solid; background: #369; padding: 6px; color: #fff; }
#msg dl.meta dt { float: left; width: 6em; font-weight: bold; }
#msg dt:after { content:':';}
#msg dl, #msg dt, #msg ul, #msg li, #header, #footer, #logmsg { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; }
#msg dl a { font-weight: bold}
#msg dl a:link { color:#fc3; }
#msg dl a:active { color:#ff0; }
#msg dl a:visited { color:#cc6; }
h3 { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; font-weight: bold; }
#msg pre { white-space: pre-line; overflow: auto; background: #ffc; border: 1px #fa0 solid; padding: 6px; }
#logmsg { background: #ffc; border: 1px #fa0 solid; padding: 1em 1em 0 1em; }
#logmsg p, #logmsg pre, #logmsg blockquote { margin: 0 0 1em 0; }
#logmsg p, #logmsg li, #logmsg dt, #logmsg dd { line-height: 14pt; }
#logmsg h1, #logmsg h2, #logmsg h3, #logmsg h4, #logmsg h5, #logmsg h6 { margin: .5em 0; }
#logmsg h1:first-child, #logmsg h2:first-child, #logmsg h3:first-child, #logmsg h4:first-child, #logmsg h5:first-child, #logmsg h6:first-child { margin-top: 0; }
#logmsg ul, #logmsg ol { padding: 0; list-style-position: inside; margin: 0 0 0 1em; }
#logmsg ul { text-indent: -1em; padding-left: 1em; }#logmsg ol { text-indent: -1.5em; padding-left: 1.5em; }
#logmsg > ul, #logmsg > ol { margin: 0 0 1em 0; }
#logmsg pre { background: #eee; padding: 1em; }
#logmsg blockquote { border: 1px solid #fa0; border-left-width: 10px; padding: 1em 1em 0 1em; background: white;}
#logmsg dl { margin: 0; }
#logmsg dt { font-weight: bold; }
#logmsg dd { margin: 0; padding: 0 0 0.5em 0; }
#logmsg dd:before { content:'\00bb';}
#logmsg table { border-spacing: 0px; border-collapse: collapse; border-top: 4px solid #fa0; border-bottom: 1px solid #fa0; background: #fff; }
#logmsg table th { text-align: left; font-weight: normal; padding: 0.2em 0.5em; border-top: 1px dotted #fa0; }
#logmsg table td { text-align: right; border-top: 1px dotted #fa0; padding: 0.2em 0.5em; }
#logmsg table thead th { text-align: center; border-bottom: 1px solid #fa0; }
#logmsg table th.Corner { text-align: left; }
#logmsg hr { border: none 0; border-top: 2px dashed #fa0; height: 1px; }
#header, #footer { color: #fff; background: #636; border: 1px #300 solid; padding: 6px; }
#patch { width: 100%; }
#patch h4 {font-family: verdana,arial,helvetica,sans-serif;font-size:10pt;padding:8px;background:#369;color:#fff;margin:0;}
#patch .propset h4, #patch .binary h4 {margin:0;}
#patch pre {padding:0;line-height:1.2em;margin:0;}
#patch .diff {width:100%;background:#eee;padding: 0 0 10px 0;overflow:auto;}
#patch .propset .diff, #patch .binary .diff {padding:10px 0;}
#patch span {display:block;padding:0 10px;}
#patch .modfile, #patch .addfile, #patch .delfile, #patch .propset, #patch .binary, #patch .copfile {border:1px solid #ccc;margin:10px 0;}
#patch ins {background:#dfd;text-decoration:none;display:block;padding:0 10px;}
#patch del {background:#fdd;text-decoration:none;display:block;padding:0 10px;}
#patch .lines, .info {color:#888;background:#fff;}
--></style>
<div id="msg">
<dl class="meta" style="font-size: 105%">
<dt style="float: left; width: 6em; font-weight: bold">Revision</dt> <dd><a style="font-weight: bold" href="http://buddypress.trac.wordpress.org/changeset/13719">13719</a><script type="application/ld+json">{"@context":"http://schema.org","@type":"EmailMessage","description":"Review this Commit","action":{"@type":"ViewAction","url":"http://buddypress.trac.wordpress.org/changeset/13719","name":"Review Commit"}}</script></dd>
<dt style="float: left; width: 6em; font-weight: bold">Author</dt> <dd>imath</dd>
<dt style="float: left; width: 6em; font-weight: bold">Date</dt> <dd>2024-01-30 05:38:27 +0000 (Tue, 30 Jan 2024)</dd>
</dl>
<pre style='padding-left: 1em; margin: 2em 0; border-left: 2px solid #ccc; line-height: 1.25; font-size: 105%; font-family: sans-serif'>`docs/user`: update the URLs settings screen documentation
- Update screenshots to latest BP version
- Explain how to use each panel of the accordion UI
Closes https://github.com/buddypress/buddypress/pull/224</pre>
<h3>Modified Paths</h3>
<ul>
<li><a href="#trunkdocsuseradministrationsettingsurlsmd">trunk/docs/user/administration/settings/urls.md</a></li>
</ul>
<h3>Added Paths</h3>
<ul>
<li><a href="#trunkdocsuserassetsbpadminsettingsurlsscreen001png">trunk/docs/user/assets/bp-admin-settings-urls-screen-001.png</a></li>
<li><a href="#trunkdocsuserassetsbpadminsettingsurlsscreen002png">trunk/docs/user/assets/bp-admin-settings-urls-screen-002.png</a></li>
<li><a href="#trunkdocsuserassetsbpadminsettingsurlsscreen003png">trunk/docs/user/assets/bp-admin-settings-urls-screen-003.png</a></li>
<li><a href="#trunkdocsuserassetsbpadminsettingsurlsscreen004png">trunk/docs/user/assets/bp-admin-settings-urls-screen-004.png</a></li>
</ul>
<h3>Removed Paths</h3>
<ul>
<li><a href="#trunkdocsuserassetsbpsettingscustomizeslugspng">trunk/docs/user/assets/bp-settings-customize-slugs.png</a></li>
</ul>
</div>
<div id="patch">
<h3>Diff</h3>
<a id="trunkdocsuseradministrationsettingsurlsmd"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/docs/user/administration/settings/urls.md</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/docs/user/administration/settings/urls.md 2024-01-29 18:31:34 UTC (rev 13718)
+++ trunk/docs/user/administration/settings/urls.md 2024-01-30 05:38:27 UTC (rev 13719)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -1,5 +1,46 @@
</span><span class="cx" style="display: block; padding: 0 10px"> # BuddyPress URLs settings
</span><span class="cx" style="display: block; padding: 0 10px">
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-Since version 12.0 of BuddyPress, you can now customize all URLs the plugin is generating to display your community content. An important change to note: BuddyPress directory pages are no longer regular WordPress pages and customizing these directory titles or URLs as well as any other BP URLs is only possible from the URLs tab of the BuddyPress settings Administration screen.
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+Since version 12.0, BuddyPress no longer uses regular WordPress pages to let site administrators customize BP Directories titles and permalinks.
</ins><span class="cx" style="display: block; padding: 0 10px">
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+BuddyPress is now automatically generating specific entries into your WordPress site's database to store the information needed by BP Components requiring a directory to list their single items (eg: the Members directory is the community members).
+
+Benefits are:
+
+- It's no more needed to manually perform WordPress page association.
+- Community content is not mixed with your regular WordPress content.
+- BuddyPress URLs customization has been extended to **every chunks** of **any** URLs generated by the plugin to display your community content.
+- BuddyPress supports any permalink structures, even the plain one!
+- You can set all BP Components titles & URLs information from one screen: the URLs tab of the BuddyPress settings.
+
+
+
+## The BP Component's directory panel
+
+Every BP Component using a directory gets an accordion panel to let you customize its title and permalink as well as potential single item screen URLs when supported (eg: Members and Groups). Open the component's panel you need to edit the title or URL for and use the form fields to set your preferences.
+
+
+
+You can use the "View" link to reach your directory page. Once you edited your directory slug, you'll need to save your changes from the "Save Settings" blue button at the bottom of the page to update your directory permalink.
+
+> [!NOTE]
+> If you need to add a link to your directory into your WordPress navigation, this [documentation page](./../navigations/README.md) is explaining how to achieve this in regular or Block Themes.
+
+## The BP Component's single item primary & secondary screens panels
+
+These panels are only available for the Groups and the Members components. To build a group or a member URL, BuddyPress simply adds the single item name (formatted to be used into an URL) at the end of the directory permalink. For single item primary screens, it adds the primary slug to the Group or Member URL and so on.
+
+This panel is the place where you'll be able to edit every URL chunk (or slug) that will be added after the single item URL.
+
+
+
+## Specific BP pages panels
+
+If registrations to your community site are allowed, BuddyPress is overriding the WordPress registration process so that it can happen on the front-end of your site (instead of the WordPress login screen). The BP registration process has a 2 steps: the member submits a registration form from the corresponding page, then once they received the activation email, they use the activation link to reach the activation page.
+
+> [!IMPORTANT]
+> Unlike directory permalinks, there's no "View" link for these specific pages as you need to log out to reach these.
+
+
+
+> [!NOTE]
+> Once you're satisfied with URLs customization, don't forget to click on the "Save Settings" blue button at the bottom of the page to save your BuddyPress URLs settings.
</ins></span></pre></div>
<a id="trunkdocsuserassetsbpadminsettingsurlsscreen001png"></a>
<div class="binary"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Added: trunk/docs/user/assets/bp-admin-settings-urls-screen-001.png</h4>
<pre class="diff"><span>
<span class="cx">(Binary files differ)
</span></span></pre></div>
<span class="cx" style="display: block; padding: 0 10px">Index: trunk/docs/user/assets/bp-admin-settings-urls-screen-001.png
</span><span class="cx" style="display: block; padding: 0 10px">===================================================================
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">--- trunk/docs/user/assets/bp-admin-settings-urls-screen-001.png 2024-01-29 18:31:34 UTC (rev 13718)
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+++ trunk/docs/user/assets/bp-admin-settings-urls-screen-001.png 2024-01-30 05:38:27 UTC (rev 13719)
</ins><span class="cx" style="display: block; padding: 0 10px">Property changes on: trunk/docs/user/assets/bp-admin-settings-urls-screen-001.png
</span><span class="cx" style="display: block; padding: 0 10px">___________________________________________________________________
</span><a id="svnmimetype"></a>
<div class="addfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Added: svn:mime-type</h4></div>
<ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+image/png
</ins><span class="cx" style="display: block; padding: 0 10px">\ No newline at end of property
</span><a id="trunkdocsuserassetsbpadminsettingsurlsscreen002png"></a>
<div class="binary"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Added: trunk/docs/user/assets/bp-admin-settings-urls-screen-002.png</h4>
<pre class="diff"><span>
<span class="cx">(Binary files differ)
</span></span></pre></div>
<span class="cx" style="display: block; padding: 0 10px">Index: trunk/docs/user/assets/bp-admin-settings-urls-screen-002.png
</span><span class="cx" style="display: block; padding: 0 10px">===================================================================
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">--- trunk/docs/user/assets/bp-admin-settings-urls-screen-002.png 2024-01-29 18:31:34 UTC (rev 13718)
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+++ trunk/docs/user/assets/bp-admin-settings-urls-screen-002.png 2024-01-30 05:38:27 UTC (rev 13719)
</ins><span class="cx" style="display: block; padding: 0 10px">Property changes on: trunk/docs/user/assets/bp-admin-settings-urls-screen-002.png
</span><span class="cx" style="display: block; padding: 0 10px">___________________________________________________________________
</span><a id="svnmimetype"></a>
<div class="addfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Added: svn:mime-type</h4></div>
<ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+image/png
</ins><span class="cx" style="display: block; padding: 0 10px">\ No newline at end of property
</span><a id="trunkdocsuserassetsbpadminsettingsurlsscreen003png"></a>
<div class="binary"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Added: trunk/docs/user/assets/bp-admin-settings-urls-screen-003.png</h4>
<pre class="diff"><span>
<span class="cx">(Binary files differ)
</span></span></pre></div>
<span class="cx" style="display: block; padding: 0 10px">Index: trunk/docs/user/assets/bp-admin-settings-urls-screen-003.png
</span><span class="cx" style="display: block; padding: 0 10px">===================================================================
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">--- trunk/docs/user/assets/bp-admin-settings-urls-screen-003.png 2024-01-29 18:31:34 UTC (rev 13718)
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+++ trunk/docs/user/assets/bp-admin-settings-urls-screen-003.png 2024-01-30 05:38:27 UTC (rev 13719)
</ins><span class="cx" style="display: block; padding: 0 10px">Property changes on: trunk/docs/user/assets/bp-admin-settings-urls-screen-003.png
</span><span class="cx" style="display: block; padding: 0 10px">___________________________________________________________________
</span><a id="svnmimetype"></a>
<div class="addfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Added: svn:mime-type</h4></div>
<ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+image/png
</ins><span class="cx" style="display: block; padding: 0 10px">\ No newline at end of property
</span><a id="trunkdocsuserassetsbpadminsettingsurlsscreen004png"></a>
<div class="binary"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Added: trunk/docs/user/assets/bp-admin-settings-urls-screen-004.png</h4>
<pre class="diff"><span>
<span class="cx">(Binary files differ)
</span></span></pre></div>
<span class="cx" style="display: block; padding: 0 10px">Index: trunk/docs/user/assets/bp-admin-settings-urls-screen-004.png
</span><span class="cx" style="display: block; padding: 0 10px">===================================================================
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">--- trunk/docs/user/assets/bp-admin-settings-urls-screen-004.png 2024-01-29 18:31:34 UTC (rev 13718)
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+++ trunk/docs/user/assets/bp-admin-settings-urls-screen-004.png 2024-01-30 05:38:27 UTC (rev 13719)
</ins><span class="cx" style="display: block; padding: 0 10px">Property changes on: trunk/docs/user/assets/bp-admin-settings-urls-screen-004.png
</span><span class="cx" style="display: block; padding: 0 10px">___________________________________________________________________
</span><a id="svnmimetype"></a>
<div class="addfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Added: svn:mime-type</h4></div>
<ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+image/png
</ins><span class="cx" style="display: block; padding: 0 10px">\ No newline at end of property
</span><a id="trunkdocsuserassetsbpsettingscustomizeslugspng"></a>
<div class="binary"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Deleted: trunk/docs/user/assets/bp-settings-customize-slugs.png</h4>
<pre class="diff"><span>
<span class="cx">(Binary files differ)
</span></span></pre></div>
</div>
</body>
</html>