Merge branch 'v5.0.0'.

.github/CONTRIBUTING.md

@@ -100,9 +100,11 @@ Before submitting a PR:
 
 - If you've updated translation strings, please check that you have used the same
   format as the other entries, for example:
+
   ```javascript
   'You can find the latest one here': 'Puoi trovare l\'ultima qui',
   ```
+
   - Both the "from" and "to" parts of each entry are surrounded by single-quotes
     (`'aa'`)
   - Any single-quotes within the "from" or "to" are escaped with a backslash

.github/ISSUE_TEMPLATE.md

@@ -24,7 +24,7 @@ What action or series of actions is the cause of the issue?
 
 ### Expected behavior
 
- What should happen?
+What should happen?
 
 ### Current behavior
 
@@ -34,9 +34,11 @@ What happens instead?
 
 - Version of the script: x.x.x - look for a line near the top of the code which
   reads:
+
   ```javascript
   version: 'w.x.y-z',
   ```
+
 - Any other details which might be related to the context;
 
 ### Extended description

.markdownlint.json

@@ -1,4 +1,5 @@
 {
   "MD009": { "br_spaces": 2 },
+  "MD013": {"code_blocks": false},
   "MD029": { "style": "ordered" }
 }

README.md

@@ -6,8 +6,8 @@ Receive customized email notifications to alert you about incoming birthdays or
 other events of your Google contacts.
 
 Have you ever wondered why on Earth would Google Calendar provide a calendar to
-remind you of your contact birthdays, but without letting you set up notifications
-for its events?  
+remind you of your contact birthdays, but without letting you set up
+notifications for its events?  
 I did. And after hours of fruitless searching and browsing I found [a post in
 the Google Help Forum][Original Google Help Forum Post] which seemed to provide
 a solution, however it did not quite work.
@@ -18,9 +18,11 @@ missing notifications on Google Calendar Birthday Calendar.
 <!-- TOC -->
 
 - [Google Contacts Events Notifier](#google-contacts-events-notifier)
+  - [Note regarding Google Plus integration](#note-regarding-google-plus-integration)
   - [Installation and setup](#installation-and-setup)
   - [Additional information](#additional-information)
     - [Stopping/uninstalling/deleting the script](#stoppinguninstallingdeleting-the-script)
+    - [Blacklisting specific events for specific contacts](#blacklisting-specific-events-for-specific-contacts)
     - [Translation](#translation)
     - [Bug and error reporting, help requests](#bug-and-error-reporting-help-requests)
       - [Unresponsive help requests](#unresponsive-help-requests)
@@ -32,36 +34,60 @@ missing notifications on Google Calendar Birthday Calendar.
 
 <!-- /TOC -->
 
+## Note regarding Google Plus integration
+
+This script used to include an option to extract additional info about your
+contacts from your Google Plus account. As Google Plus is scheduled to be killed
+between March and April 2019 (see [this blog post from Google][Google Plus
+closing] and [this follow up][Google Plus closing 2] for more details) this
+feature had to be removed.
+
+If you are using any version of this script up to and including v4.1.0 you might
+have received one or more emails from Google explaining this and asking you to
+address this issue in your projects.  
+If this is the case the only action you need to take regarding GCEN is to update
+your script to a more recent version (more recent than v4.1.0) and to remove the
+dependecy from the Google Plus API by:
+
+- Opening your script.
+- Clicking on `Resources->Advanced Google services` in the menu at the top.
+- Disabling the `Google+ API` in the list of available APIs.
+- Opening the Google Cloud platform API dashboard with the link provided at the
+  bottom.
+- Searching for `Google+ API` in the search bar at the top.
+- Disabling the API by clicking on the `Disable` button.
+
 ## Installation and setup
 
-Follow [this guide][Setup and installation guide] to install and setup the script
-correctly.
+Follow [this guide][Setup and installation guide] to install and setup the
+script correctly.
 
 ## Additional information
 
 ### Stopping/uninstalling/deleting the script
 
-If you just want to stop receiving the notifications, but want to keep the script
-for future use just open your script and click `Run->notifStop` in the menu at
-the top.
+If you just want to stop receiving the notifications, but want to keep the
+script for future use just open your script and click `Run->notifStop` in the
+menu at the top.
 
-If you want to stop using the script and want to delete it completely follow these
-steps:
+If you want to stop using the script and want to delete it completely follow
+these steps:
 
 1. Locate the script in [Google Drive][Google Drive website]:
    - It should be in the folder you put it into when you created it.
-   - If you deleted the file you can look in the [trash folder][Google Drive trash]
-     and recover it from there.
+   - If you deleted the file you can look in the [trash folder][Google Drive
+     trash] and recover it from there.
 2. Open the script and click `Run->notifStop` in the menu at the top.
-3. In the same menu click `Run->notifStatus`, then `View->Log` and confirm
-   that the notifications were stopped successfully.
+3. In the same menu click `Run->notifStatus`, then `View->Log` and confirm that
+   the notifications were stopped successfully.
 4. Close the script and open [this Google page][Google connected apps], find the
-   the script (it should have the name you gave it during installation) and click
-   on "Remove access"
-5. If everything went right it should be safe to delete the script file from Google
-   Drive.  
-   If you want to be extra sure you can wait some days to confirm that no email is
-   sent to you anymore and only then delete the script file: this is up to you.
+   the script (it should have the name you gave it during installation) and
+   click on "Remove access"
+5. If everything went right it should be safe to delete the script file from
+   Google Drive.  
+   If you want to be extra sure you can wait some days to confirm that no email
+   is sent to you anymore and only then delete the script file: this is up to
+   you.
 
 ### Blacklisting specific events for specific contacts
 
@@ -74,8 +100,8 @@ configuration variable at the top of the script:
 3. `Custom`
 
 but you can also achieve more fine-grained control per-contact by adding a
-custom-field when editing a contact (click `Add->Custom...`), setting the label of
-that field to `notificationBlacklist`, and setting its content to a
+custom-field when editing a contact (click `Add->Custom...`), setting the label
+of that field to `notificationBlacklist`, and setting its content to a
 comma-separated list of field-names. In the following example, the script would
 notify about Fred's birthday but not his anniversary or his SpecialSecretDay due
 to the blacklist:
@@ -97,19 +123,19 @@ The text of the email notification can be translated into any language if a
 translation for that language is provided to the script. Some languages already
 have a translation, but you can easily add your own.
 
-To learn more about translations (how to create your own one, how to share
-it with us so that it can be used by other users...) please read the
-[translation guide][Translation guide].
+To learn more about translations (how to create your own one, how to share it
+with us so that it can be used by other users...) please read the [translation
+guide][Translation guide].
 
 ### Bug and error reporting, help requests
 
 First of all _before submitting a new error, bug or help request_, please,
-__verify that you followed [the setup instructions][Setup and installation guide]
-to the letter.__
+__verify that you followed [the setup instructions][Setup and installation
+guide] to the letter.__
 
 To report a bug or an error or to request help with this script please use [this
-project GitHub issue page][Project issue page]: the collaborators will be notified
-immediately and will provide help as soon as possible.
+project GitHub issue page][Project issue page]: the collaborators will be
+notified immediately and will provide help as soon as possible.
 
 Please follow the template provided (which you can also [preview here][Issue
 template file]) when opening a new issue and include:
@@ -121,8 +147,8 @@ template file]) when opening a new issue and include:
   your email: obscure or remove them as all the issues and relative messages are
   publicly visible.
 
-These pieces of information are really necessary: without them nobody will be able
-to help you.
+These pieces of information are really necessary: without them nobody will be
+able to help you.
 
 #### Unresponsive help requests
 
@@ -146,60 +172,56 @@ This script is constantly updated to fix bugs and add new features: keeping it
 updated to the latest version is really easy:
 
 1. Whenever a new stable version is released you will see a line of text at the
-   end of your daily email notification telling you to click on a link to get the
-   latest version;
-2. If you do so you will be taken to a page with a description of the new release;
-3. The description will contain a precise step by step guide on how to update the
-   script to this version: follow it closely and you should not have any problem;
+   end of your daily email notification telling you to click on a link to get
+   the latest version;
+2. If you do so you will be taken to a page with a description of the new
+   release;
+3. The description will contain a precise step by step guide on how to update
+   the script to this version: follow it closely and you should not have any
+   problem;
 4. You might want to follow the setup procedure again, because some steps might
    have been added in the new version since the previous one.
 5. After updating the code always click `Run->notifStop` and `Run->notifStart`
    in the top menu to finish the update process.
 
 Note: you might be asked to grant some new permissions to the script. There is
-nothing wrong with this: it just means that the new version requires some permissions
-that the previous version did not.  
+nothing wrong with this: it just means that the new version requires some
+permissions that the previous version did not.  
 You can read the full list of the permissions and why they are required
 [here][Permissions list]
 
 ### Permissions required
 
 When running the script for the first time or after an update you might be asked
-by Google to "grant some permissions" to the script. This happens because the script
-needs your explicit permission to access your data.
-
-This is an exhaustive description of the reason the script needs each of the permissions:
-
-- **Know your age range and language + View your email addresses**  
-  This is needed to retrieve information about your Google Plus contacts, especially
-  those who you have not added in your Google Contacts, but just followed on Google
-  Plus. The script will only get information about people who appear in your birthday
-  calendar. If you prefer to not access Google Plus at all set
-  `settings.user.accessGooglePlus = false` before running any functions and do not
-  enable the Google+ API (then you won't be prompted for this permission).
+by Google to "grant some permissions" to the script. This happens because the
+script needs your explicit permission to access your data.
+
+This is an exhaustive description of the reason the script needs each of the
+permissions:
+
 - **Manage your Google Contacts**  
   This lets the script access information about your contacts (names, email
   addresses, birthdays). The script will not modify any of your contacts.
 - **Manage your calendars**  
-  This lets the script access your birthday and events calendar. The script
-  will get the events from this calendar only and will never modify any event or
+  This lets the script access your birthday and events calendar. The script will
+  get the events from this calendar only and will never modify any event or
   calendar.
 - **Allow this application to run when you are not present**  
   This is needed to run the script every day at the hour you specified.
 - **Send email as you**  
-  Obviously this script needs your authorization to send you the email notifications.
-  It won't send any other email to anyone.
+  Obviously this script needs your authorization to send you the email
+  notifications. It won't send any other email to anyone.
 - **Connect to an external service**  
-  This permission is needed to check for updates and to load the profile images of
-  your contacts.
+  This permission is needed to check for updates and to load the profile images
+  of your contacts.
 
 ## Contributing
 
 Google Contacts Events Notifier is an open source project: if you want to
 know how to contribute please read the [CONTRIBUTING][Contributing file] file.
 
-If you just want to contribute with a translation then the
-[translation guide][Translation guide] might be a better place to start.
+If you just want to contribute with a translation then the [translation
+guide][Translation guide] might be a better place to start.
 
 ## License
 
@@ -210,24 +232,42 @@ file].
 
 - [GioBonvi (Giorgio Bonvicini)][Github GioBonvi] created the project and is
   primary maintainer;
-- Google user `ajparag` for the [code][Original Google Help Forum
-  post] that inspired this project;
+- Google user `ajparag` for the [code][Original Google Help Forum post] that
+  inspired this project;
 - [rowanthorpe (Rowan Thorpe)][GitHub rowanthorpe], whose help was invaluable:
   he added many new features, refactored the code heavily and solved many bugs;
 - [baatochan (Bartosz Rodziewicz)][Github baatochan], for his various contributions
   both in solving issues and in adding new features;
 - those users who provided translations for the script:
-  - [rowanthorpe (Rowan Thorpe)][GitHub rowanthorpe] - Greek;
+  - [rowanthorpe (Rowan Thorpe)][GitHub rowanthorpe] and [apo-mak][Github apo-mak
+    ] - Greek;
   - [lboullo0 (Lucas)][Github lboullo0] - Spanish;
   - [muzavan (Muhammad Reza Irvanda)][Github muzavan] - Indonesian;
-  - [DrKrakower][Github DrKrakower] and Simone Sottopietra - German;
+  - [DrKrakower][Github DrKrakower], Simone Sottopietra, [shutdown27 (Peter
+    Berweiler)][Github shutdown27] and [SuperSandro2000 (Sandro Jäckel)][Github
+    SuperSandro2000] - German;
   - [cezarylaksa][Github cezarylaksa] and [baatochan (Bartosz
     Rodziewicz)][Github baatochan] - Polish;
-  - [JayForce][GitHub JayForce] - French;
+  - [JayForce][GitHub JayForce], [Vinetos (Valentin Chassignol)][GitHub Vinetos]
+    and [krial057][Github krial057] - French;
   - [88scythe][GitHub 88scythe] - Dutch;
   - [miguel-r (Miguel Ribeiro)][Github miguel-r] - Portuguese;
+  - [AnnaH][Github AnnaH] - Thai;
+  - [nadyafebi (Nadya Febiana Djojosantoso)][Github nadyafebi] and [jovanzers
+    (Jovan Ferryal E. F.)][Github jovanzers] - Indonesian;
+  - [cemysf (Cem Yusuf Aydogdu)][Github cemysf] - Turkish;
+  - [MatheusNtg][Github MatheusNtg] - Brazilian Portuguese;
+  - [goggenb (Geir-Ove Bøe)][Github goggenb] - Norwegian;
+  - [phg98][Github phg98] - Korean;
+  - [kallanar (Dainius Silvanavičius)][Github kallanar] - Lithuanian;
+  - [vladimir-kirillovskiy][Github vladimir-kirillovskiy] - Russian;
+  - [AlesJiranek (Aleš Jiránek)][Github AlesJiranek] - Czech;
+  - [alialamshahi (Ali Alamshahi)][Github alialamshahi] - Farsi;
+  - [GisliNielsen (Gisli Nielsen)][Github GisliNielsen] - Norwegian Bokmål
 - all the other contributors who are listed [here][Project contributors page];
 
+[Google Plus closing]: https://blog.google/technology/safety-security/project-strobe/
+[Google Plus closing 2]: https://www.blog.google/technology/safety-security/expediting-changes-google-plus/
 [Project documentation]: https://giobonvi.github.io/GoogleContactsEventsNotifier
 [Project issue page]: https://github.com/GioBonvi/GoogleContactsEventsNotifier/issues
 [Project contributors page]: https://github.com/GioBonvi/GoogleContactsEventsNotifier/graphs/contributors
@@ -251,3 +291,20 @@ file].
 [Github JayForce]: https://github.com/JayForce
 [Github 88scythe]: https://github.com/88scythe
 [Github miguel-r]: https://github.com/miguel-r
+[Github Vinetos]: https://github.com/Vinetos
+[Github AnnaH]: https://github.com/AnnaH
+[Github shutdown27]: https://github.com/shutdown27
+[Github nadyafebi]: https://github.com/nadyafebi
+[Github cemysf]: https://github.com/cemysf
+[Github MatheusNtg]: https://github.com/MatheusNtg
+[Github goggenb]: https://github.com/goggenb
+[Github phg98]: https://github.com/phg98
+[Github SuperSandro2000]: https://github.com/SuperSandro2000
+[Github kallanar]: https://github.com/kallanar
+[Github krial057]: https://github.com/krial057
+[Github vladimir-kirillovskiy]: https://github.com/vladimir-kirillovskiy
+[Github AlesJiranek]: https://github.com/AlesJiranek
+[Github jovanzers]: https://github.com/jovanzers
+[Github alialamshahi]: https://github.com/alialamshahi
+[Github GisliNielsen]: https://github.com/GisliNielsen
+[Github apo-mak]: https://github.com/apo-mak