Problem/Motivation

Update links in the installer to make them more clear and accurate. Some are outdated and add some where it could help the user.

Proposed resolution

  1. The link given for for problems with the file system needs to refer to the installation guide, https://www.drupal.org/documentation/install/settings-file, not webhosting

Remaining tasks

  • Create patch
  • Test
  • Review

User interface changes

Text changes

API changes

N/A

Comments

jhodgdon’s picture

Issue tags: +Usability, +ui-text
ifrik’s picture

Issue tags: +SprintWeekend2015Queue

I will be working on this during the SprintWeekend 16/17 January.

ifrik’s picture

Title: Review "Requirement problem" error messages » Review error messages and notifications from the installer
Issue summary: View changes
ifrik’s picture

StatusFileSize
new2.27 KB

Added services.yml to the permission notification on the "Configure site" in these installer and linked it to the online installation guide https://www.drupal.org/documentation/install/settings-file instead of the the webhosting help page.

ifrik’s picture

StatusFileSize
new6.07 KB

Linked the error messages about missing and non-writable files directory, settings.php and service.yml to the online installation guide.

ifrik’s picture

Status: Active » Needs review
jmarkel’s picture

Assigned: Unassigned » jmarkel

Reviewing (#sprintweekend2015)

ifrik’s picture

Status: Needs review » Needs work

just noticed that I used @ instead of ! for the links. That needs changing

jmarkel’s picture

@ifrik are you re-rolling to fix that, or shall I do it?

jmarkel’s picture

StatusFileSize
new10.7 KB

New patch which changes @ to ! for urls, a few additional http:'s changed to https:, added path back in for one mention of INSTALL.txt, changed description of the server-settings docs from 'online handbook' to "online 'Webhosting issues' documentation"

jmarkel’s picture

Status: Needs work » Needs review
Issue tags: -SprintWeekend2015 +SprintWeekend2015Queue
jmarkel’s picture

Assigned: jmarkel » Unassigned
kristen pol’s picture

Issue summary: View changes

Update issue summary.

karengrey’s picture

Status: Needs review » Needs work

In a/core/includes/install.core.inc
There is a typo on line 1956:
consult the <a href="@!andbook_url">online
should be
consult the <a href="!handbook_url">online

Line 2149, the @ was not replaced with an ! for @handbook_url

In a/core/lib/Drupal/Core/Installer/Form/SiteConfigureForm.php
Line 131
drupal_set_message(t('All necessary changes to %dir, %file and %services have been made, so you should remove write permissions to them now in order to avoid security risks. If you are unsure how to do so, consult the <a href="!installation">online installation guide</a>.', array('%dir' => $settings_dir, '%file' => $settings_file, '%services' => $services_file, '!installation' => 'https://www.drupal.org/documentation/install/settings-file')), 'warning');

The array should be on a seperate line as per code conduct

jmarkel’s picture

Assigned: Unassigned » jmarkel
jmarkel’s picture

jmarkel’s picture

Assigned: jmarkel » Unassigned
Status: Needs work » Needs review
StatusFileSize
new10.81 KB

Thanks so much @kristen-pol and @karengreen - I've updated and re-rolled the patch.

jmarkel’s picture

karengrey’s picture

Assigned: Unassigned » karengrey
Status: Needs review » Needs work

There is still an ampersand on line 1956 which needs removing
<a href="@!handbook_url">

Great work on splitting the array out onto seperate lines as per code conduct, it would be good to do this to all t() functions now to make the files consistant.

I'd be happy to assign this to myself and supply the patch

jmarkel’s picture

Dang! Careless me :-(

Sure - I'll be tied up today, and would like to get this one tied up with a bow, so by all means go for it. I'll review when it's done...

karengrey’s picture

Assigned: karengrey » Unassigned
Status: Needs work » Needs review
StatusFileSize
new22.5 KB

New patch created. I've also tidied up some code to match conduct
This is my first patch to core to hopefully its a good one!
Thanks,

Status: Needs review » Needs work

The last submitted patch, 22: 2371585-22-notifications-permissions.patch, failed testing.

Status: Needs work » Needs review

Status: Needs review » Needs work

The last submitted patch, 22: 2371585-22-notifications-permissions.patch, failed testing.

karengrey’s picture

Status: Needs work » Needs review
StatusFileSize
new16.97 KB
new16.97 KB

I had some issues with my patch, so re-done it all and now included an interdiff between patch in #18 and this one
Thanks,

jhodgdon’s picture

Status: Needs review » Needs work

Thanks for the patches!

A few small things I noticed in the latest patch:

a)

online \'Webhosting issues\' documentation

This should be using double quotes. Occurs several times in the patch.

b)

The installer requires to contact the translation server to download a translation file. 

This is not good English. Should be something like "... installer needs to be able to contact...".

c)

The %language translation file is not available at the translation server. 

at ==> on

d)

The @drupal installer requires write permissions to %file during the installation process.  For more information,

Should only be 1 space between sentences, not two.

e)

...and create a new one by copying the %default_file file to %file.

No "the" here.

f)

All necessary changes to %dir, %file and %services have been made,

Needs comma after %file too.

g) In system.install:

For more information, see INSTALL.txt or the <a href="!installation">online installation guide</a>.'

This seems inconsistent with the wording being used in install.core.inc for the same purpose. Please make them all the same.

h) Generally, we like to keep patches to an issue only addressing the problems of this issue. So the changes like adding commas to array elements etc. are really NOT a good idea for this patch. It would make it much easier to review this patch, and much more likely to get committed, if those were removed. Just patch this issue and if necessary file a separate issue to address other problems that are unrelated to this issue.

Thanks!

rachel_norfolk’s picture

Assigned: Unassigned » rachel_norfolk
Issue tags: +#dclondon

working on this at #dclondon

rachel_norfolk’s picture

Assigned: rachel_norfolk » Unassigned
Status: Needs work » Needs review
StatusFileSize
new15.85 KB
new11.02 KB

I have taken the comments at #28, noted below...

a/ OK
b/ OK
c/ OK
d/ OK
e/ OK
f/ OK
g/ OK
h/ Where the only difference was the addition of a comma, as per coding standards, I have reverted that change. Where other changes have taken place in that array, I have left the comma in as part of that work.

kae76’s picture

Assigned: Unassigned » kae76

working on this at #dclondon

kae76’s picture

Reviewed: at #dclondon

Applied patch (#30) and installed Drupal, no errors found.

Ref: #28 comments:
a/ corrected
b/ corrected
c/ corrected
d/ corrected
e/ - “the” is still there
f/ corrected
g/ corrected
h/ corrected as far as I could tell

kae76’s picture

Assigned: kae76 » Unassigned
rachel_norfolk’s picture

Issue tags: -#dclondon +dclondon
jhodgdon’s picture

Status: Needs review » Needs work

Thanks for the review @kae76 - looks like the patch needs a bit of work, based on (e).

ifrik’s picture

Re-rolling the patch.

The last submitted patch, 30: 2371585-30-notifications-permissions.patch, failed testing.

ifrik’s picture

Status: Needs work » Needs review
Issue tags: +Barcelona2015
StatusFileSize
new14.95 KB

The changes in the placeholder required a re-roll, so I've done that.

I've taken up the open questions from the comments above.

The services.yml file is not created/required anymore during the installation, so I did not include that in the re-roll.

In the error messages about creating directories and settings permissions, I've consistently labelled it "online documentation" and linked to https://www.drupal.org/documentation/install/settings-file

I've made an issue to update that page with several changes, and this should include a link to the relevant pages that explain how to do this for sitebuilders that don't have direct access to the default directory #2575837: Update the Step 3 page in the install documentation

ifrik’s picture

Status: Needs review » Needs work

I get an alert to tell me to change the permissions for sites/default, and I'm not quite sure whether that's introduced by the patch.
I'll check on that later.

ifrik’s picture

Status: Needs work » Needs review

Status: Needs review » Needs work

The last submitted patch, 39: 2371585-39-notifications-permissions.patch, failed testing.

rachel_norfolk’s picture

Having a look at why the test fails...

ifrik’s picture

Somehow this ended up overlapping with #2543580: Post-install message referrs to "handbook" and links to irrelevant page, which makes it fail, but also came up with a different solution for all the links.

I'll check on what to do with it.

Version: 8.0.x-dev » 8.1.x-dev

Drupal 8.0.6 was released on April 6 and is the final bugfix release for the Drupal 8.0.x series. Drupal 8.0.x will not receive any further development aside from security fixes. Drupal 8.1.0-rc1 is now available and sites should prepare to update to 8.1.0.

Bug reports should be targeted against the 8.1.x-dev branch from now on, and new development or disruptive changes should be targeted against the 8.2.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

Version: 8.1.x-dev » 8.2.x-dev

Drupal 8.1.9 was released on September 7 and is the final bugfix release for the Drupal 8.1.x series. Drupal 8.1.x will not receive any further development aside from security fixes. Drupal 8.2.0-rc1 is now available and sites should prepare to upgrade to 8.2.0.

Bug reports should be targeted against the 8.2.x-dev branch from now on, and new development or disruptive changes should be targeted against the 8.3.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

Version: 8.2.x-dev » 8.3.x-dev

Drupal 8.2.6 was released on February 1, 2017 and is the final full bugfix release for the Drupal 8.2.x series. Drupal 8.2.x will not receive any further development aside from critical and security fixes. Sites should prepare to update to 8.3.0 on April 5, 2017. (Drupal 8.3.0-alpha1 is available for testing.)

Bug reports should be targeted against the 8.3.x-dev branch from now on, and new development or disruptive changes should be targeted against the 8.4.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

Version: 8.3.x-dev » 8.4.x-dev

Drupal 8.3.6 was released on August 2, 2017 and is the final full bugfix release for the Drupal 8.3.x series. Drupal 8.3.x will not receive any further development aside from critical and security fixes. Sites should prepare to update to 8.4.0 on October 4, 2017. (Drupal 8.4.0-alpha1 is available for testing.)

Bug reports should be targeted against the 8.4.x-dev branch from now on, and new development or disruptive changes should be targeted against the 8.5.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

Version: 8.4.x-dev » 8.5.x-dev

Drupal 8.4.4 was released on January 3, 2018 and is the final full bugfix release for the Drupal 8.4.x series. Drupal 8.4.x will not receive any further development aside from critical and security fixes. Sites should prepare to update to 8.5.0 on March 7, 2018. (Drupal 8.5.0-alpha1 is available for testing.)

Bug reports should be targeted against the 8.5.x-dev branch from now on, and new development or disruptive changes should be targeted against the 8.6.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

Version: 8.5.x-dev » 8.6.x-dev

Drupal 8.5.6 was released on August 1, 2018 and is the final bugfix release for the Drupal 8.5.x series. Drupal 8.5.x will not receive any further development aside from security fixes. Sites should prepare to update to 8.6.0 on September 5, 2018. (Drupal 8.6.0-rc1 is available for testing.)

Bug reports should be targeted against the 8.6.x-dev branch from now on, and new development or disruptive changes should be targeted against the 8.7.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

Version: 8.6.x-dev » 8.8.x-dev

Drupal 8.6.x will not receive any further development aside from security fixes. Bug reports should be targeted against the 8.8.x-dev branch from now on, and new development or disruptive changes should be targeted against the 8.9.x-dev branch. For more information see the Drupal 8 and 9 minor version schedule and the Allowed changes during the Drupal 8 and 9 release cycles.

Version: 8.8.x-dev » 8.9.x-dev

Drupal 8.8.7 was released on June 3, 2020 and is the final full bugfix release for the Drupal 8.8.x series. Drupal 8.8.x will not receive any further development aside from security fixes. Sites should prepare to update to Drupal 8.9.0 or Drupal 9.0.0 for ongoing support.

Bug reports should be targeted against the 8.9.x-dev branch from now on, and new development or disruptive changes should be targeted against the 9.1.x-dev branch. For more information see the Drupal 8 and 9 minor version schedule and the Allowed changes during the Drupal 8 and 9 release cycles.

quietone’s picture

Title: Review error messages and notifications from the installer » Update and add links in the installer
Version: 8.9.x-dev » 9.3.x-dev
Status: Needs work » Needs review
Issue tags: +Bug Smash Initiative
StatusFileSize
new8.79 KB

Triaging for Bug Smash.

There are some changes in the existing patch that are still relevant. For one, they change a link pointing to the webhosting issues page that was last changed in 2012 to a more recent page.

I decided to reroll the patch. Giving the age of the previous patch, the changes to install.core.inc and this is only about 10K, I have not made a interdiff.

Still need to update the IS.

quietone’s picture

Issue summary: View changes

Updated the IS.

Version: 9.3.x-dev » 9.4.x-dev

Drupal 9.3.0-rc1 was released on November 26, 2021, which means new developments and disruptive changes should now be targeted for the 9.4.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

Version: 9.4.x-dev » 9.5.x-dev

Drupal 9.4.0-alpha1 was released on May 6, 2022, which means new developments and disruptive changes should now be targeted for the 9.5.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

Version: 9.5.x-dev » 10.1.x-dev

Drupal 9.5.0-beta2 and Drupal 10.0.0-beta2 were released on September 29, 2022, which means new developments and disruptive changes should now be targeted for the 10.1.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

needs-review-queue-bot’s picture

Status: Needs review » Needs work
StatusFileSize
new144 bytes

The Needs Review Queue Bot tested this issue. It either no longer applies to Drupal core, or fails the Drupal core commit checks. Therefore, this issue status is now "Needs work".

Apart from a re-roll or rebase, this issue may need more work to address feedback in the issue or MR comments. To progress an issue, incorporate this feedback as part of the process of updating the issue. This helps other contributors to know what is outstanding.

Consult the Drupal Contributor Guide to find step-by-step guides for working with issues.

Version: 10.1.x-dev » 11.x-dev

Drupal core is moving towards using a “main” branch. As an interim step, a new 11.x branch has been opened, as Drupal.org infrastructure cannot currently fully support a branch named main. New developments and disruptive changes should now be targeted for the 11.x branch, which currently accepts only minor-version allowed changes. For more information, see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

quietone’s picture

Status: Needs work » Closed (outdated)

The destination URL here directs to old Drupal 7 documentation. In #3552836: Installer "online handbook" link after installation leads to 404 in Drupal 11 a redirect has been as been added to direct the URl to a page about file permissions. That makes this outdated. I have updated credit.

Thanks all!

Now that this issue is closed, review the contribution record.

As a contributor, attribute any organization that helped you, or if you volunteered your own time.

Maintainers, credit people who helped resolve this issue.