improve configuration wording, adjust self check

cfg/conf.sample.php

@@ -7,9 +7,10 @@
 ; (optional) set a project name to be displayed on the website
 ; name = "PrivateBin"
 
-; The full URL, with the domain name and directories that point to the PrivateBin files
+; The full URL, with the domain name and directories that point to the
-; This URL is essential to allow Opengraph images to be displayed on social networks
+; PrivateBin files, including an ending slash (/). This URL is essential to
-; basepath = ""
+; allow Opengraph images to be displayed on social networks.
+; basepath = "https://privatebin.example.com/"
 
 ; enable or disable the discussion feature, defaults to true
 discussion = true
@@ -55,9 +56,9 @@ languageselection = false
 ; if this is set and language selection is disabled, this will be the only language
 ; languagedefault = "en"
 
-; (optional) URL shortener address to offer after a new paste is created
+; (optional) URL shortener address to offer after a new paste is created.
-; it is suggested to only use this with self-hosted shorteners as this will leak
+; It is suggested to only use this with self-hosted shorteners as this will leak
-; the pastes encryption key
+; the pastes encryption key.
 ; urlshortener = "https://shortener.example.com/api?link="
 
 ; (optional) Let users create a QR code for sharing the paste URL with one click.
@@ -229,18 +230,18 @@ dir = PATH "data"
 ;secretkey = "secret access key"
 
 [yourls]
-; don't mix this up with "urlshortener" config item:
+; When using YOURLS as a "urlshortener" config item:
-; - when using a standard configuration, "urlshortener" will point to the YOURLS
+; - By default, "urlshortener" will point to the YOURLS API URL, with or without
-;   API, including access credentials, and will be part of the PrivateBin public
+;   credentials, and will be visible in public on the PrivateBin web page.
-;   web page (insecure!)
+;   Only use this if you allow short URL creation without credentials.
-; - when using the parameters in this section ("signature" and "apiurl"),
+; - Alternatively, using the parameters in this section ("signature" and
-;   "urlshortener" will point to a fixed PrivateBin page
+;   "apiurl"), "urlshortener" needs to point to the base URL of your PrivateBin
-;   ("$basepath/shortenviayourls?link=") and that URL will in turn call YOURLS
+;   instance with "shortenviayourls?link=" appended. For example:
-;   server-side, using the URL from "apiurl" and the "access signature" from the
+;   urlshortener = "${basepath}shortenviayourls?link="
-;   "signature" parameters below.
+;   This URL will in turn call YOURLS on the server side, using the URL from
+;   "apiurl" and the "access signature" from the "signature" parameters below.
 
 ; (optional) the "signature" (access key) issued by YOURLS for the using account
 ; signature = ""
-
 ; (optional) the URL of the YOURLS API, called to shorten a PrivateBin URL
-; apiurl = ""
+; apiurl = "https://yourls.example.com/yourls-api.php"

lib/YourlsProxy.php

@@ -48,7 +48,7 @@ class YourlsProxy
      */
     public function __construct(Configuration $conf, $link)
     {
-        if (strpos($link, $conf->getKey('basepath') . '/?') === false) {
+        if (strpos($link, $conf->getKey('basepath') . '?') === false) {
             $this->_error = 'Trying to shorten a URL that isn\'t pointing at our instance.';
             return;
         }

tst/JsonApiTest.php

@@ -272,7 +272,7 @@ class JsonApiTest extends PHPUnit_Framework_TestCase
     {
         $mock_yourls_service                = $this->_path . DIRECTORY_SEPARATOR . 'yourls.json';
         $options                            = parse_ini_file(CONF, true);
-        $options['main']['basepath']        = 'https://example.com/path';
+        $options['main']['basepath']        = 'https://example.com/path/';
         $options['main']['urlshortener']    = 'https://example.com/path/shortenviayourls?link=';
         $options['yourls']['apiurl']        = $mock_yourls_service;
         Helper::createIniFile(CONF, $options);

tst/YourlsProxyTest.php

@@ -20,7 +20,7 @@ class YourlsProxyTest extends PHPUnit_Framework_TestCase
         }
         $this->_mock_yourls_service         = $this->_path . DIRECTORY_SEPARATOR . 'yourls.json';
         $options                            = parse_ini_file(CONF_SAMPLE, true);
-        $options['main']['basepath']        = 'https://example.com';
+        $options['main']['basepath']        = 'https://example.com/';
         $options['main']['urlshortener']    = 'https://example.com/shortenviayourls?link=';
         $options['yourls']['apiurl']        = $this->_mock_yourls_service;
         Helper::confBackup();