Developer Documentation

  • Bug fixes for general core bugs in 3.11.x will end 14 Nov 2022 (12 months plus 6 months extension).
  • Bug fixes for security issues in 3.11.x will end 13 Nov 2023 (18 months plus 12 months extension).
  • PHP version: minimum PHP 7.3.0 Note: minimum PHP version has increased since Moodle 3.10. PHP 7.4.x is supported too.
  • /lang/en/ -> mnet.php (source)

    Differences Between: [Versions 37 and 311]

       1  <?php
       2  // This file is part of Moodle -
       3  //
       4  // Moodle is free software: you can redistribute it and/or modify
       5  // it under the terms of the GNU General Public License as published by
       6  // the Free Software Foundation, either version 3 of the License, or
       7  // (at your option) any later version.
       8  //
       9  // Moodle is distributed in the hope that it will be useful,
      10  // but WITHOUT ANY WARRANTY; without even the implied warranty of
      12  // GNU General Public License for more details.
      13  //
      14  // You should have received a copy of the GNU General Public License
      15  // along with Moodle.  If not, see <>.
      17  /**
      18   * Strings for component 'mnet', language 'en', branch 'MOODLE_20_STABLE'
      19   *
      20   * @package   core_mnet
      21   * @copyright 1999 onwards Martin Dougiamas  {@link}
      22   * @license GNU GPL v3 or later
      23   */
      25  $string['aboutyourhost'] = 'About your server';
      26  $string['accesslevel'] = 'Access level';
      27  $string['addhost'] = 'Add host';
      28  $string['addnewhost'] = 'Add a new host';
      29  $string['addtoacl'] = 'Add to access control';
      30  $string['allhosts'] = 'All hosts';
      31  $string['allhosts_no_options'] = 'No options are available when viewing multiple hosts';
      32  $string['allow'] = 'Allow';
      33  $string['applicationtype'] = 'Application type';
      34  $string['authfail_nosessionexists'] = 'Authorisation failed: the mnet session does not exist.';
      35  $string['authfail_sessiontimedout'] = 'Authorisation failed: the mnet session has timed out.';
      36  $string['authfail_usermismatch'] = 'Authorisation failed: the user does not match.';
      37  $string['authmnetdisabled'] = 'MNet authentication plugin is <strong>disabled</strong>.';
      38  $string['badcert'] = 'This is not a valid certificate.';
      39  $string['certdetails'] = 'Cert details';
      40  $string['configmnet'] = 'MNet allows communication of this server with other servers or services.';
      41  $string['couldnotgetcert'] = 'No certificate found at <br />{$a}. <br />The host may be down or incorrectly configured.';
      42  $string['couldnotmatchcert'] = 'This does not match the certificate currently published by the webserver.';
      43  $string['courses'] = 'courses';
      44  $string['courseson'] = 'courses on';
      45  $string['currentkey'] = 'Current public key';
      46  $string['current_transport'] = 'Current transport';
      47  $string['databaseerror'] = 'Could not write details to the database.';
      48  $string['deleteaserver'] = 'Deleting a server';
      49  $string['deletehost'] = 'Delete host';
      50  $string['deletedhostinfo'] = 'This host has been deleted. If you want to undelete it, switch the deleted status back to \'No\'.';
      51  $string['deletedhosts'] = 'Deleted hosts: {$a}';
      52  $string['deletekeycheck'] = 'Are you absolutely sure you want to delete this key?';
      53  $string['deleteoutoftime'] = 'Your 60-second window for deleting this key has expired. Please start again.';
      54  $string['deleteuserrecord'] = 'SSO ACL: delete record for user \'{$a->user}\' from {$a->host}.';
      55  $string['deletewrongkeyvalue'] = 'An error has occurred. If you were not trying to delete your server\'s SSL key, it is possible you have been the subject of a malicious attack. No action has been taken.';
      56  $string['deny'] = 'Deny';
      57  $string['description'] = 'Description';
      58  $string['duplicate_usernames'] = 'We failed to create an index on the columns "mnethostid" and "username" in your user table.<br />This can occur when you have <a href="{$a}" target="_blank">duplicate usernames in your user table</a>.<br />Your upgrade should still complete successfully. Click on the link above, and instructions on fixing this problem will appear in a new window. You can attend to that at the end of the upgrade.<br />';
      59  $string['enabled_for_all'] = '(This service has been enabled for all hosts).';
      60  $string['enterausername'] = 'Please enter a username, or a list of usernames separated by commas.';
      61  $string['error7020'] = 'This error normally occurs if the remote site has created a record for you with the wrong wwwroot, for example, instead of Please contact the administrator of the remote site with your wwwroot (as specified in config.php) and ask them to update the record for your host.';
      62  $string['error7022'] = 'The message you sent to the remote site was encrypted properly, but not signed. This is very unexpected; you should probably file a bug if this occurs (giving as much information as possible about the application versions in question etc).';
      63  $string['error7023'] = 'The remote site has tried to decrypt your message with all the keys it has on record for your site. They have all failed. You might be able to fix this problem by manually re-keying with the remote site. This is unlikely to occur unless you\'ve been out of communication with the remote site for a few months.';
      64  $string['error7024'] = 'You send an unencrypted message to the remote site, but the remote site doesn\'t accept unencrypted communication from your site. This is very unexpected; you should probably file a bug if this occurs (giving as much information as possible about the application versions in question, etc).';
      65  $string['error7026'] = 'The key that your message was signed with differs from the key that the remote host has on file for your server. Further, the remote host attempted to fetch your current key and failed to do so. Please manually re-key with the remote host and try again.';
      66  $string['error709'] = 'The remote site failed to obtain a SSL key from you.';
      67  $string['eventaccesscontrolcreated'] = 'Access control created';
      68  $string['eventaccesscontrolupdated'] = 'Access control updated';
      69  $string['expired'] = 'This key expired on';
      70  $string['expires'] = 'Valid until';
      71  $string['expireyourkey'] = 'Delete this key';
      72  $string['expireyourkeyexplain'] = 'Moodle automatically rotates your keys every 28 days (by default) but you have the option to <em>manually</em> expire this key at any time. This will only be useful if you believe this key has been compromised. A replacement will be immediately automatically generated.<br />Deleting this key will make it impossible for other applications to communicate with you, until you manually contact each administrator and provide them with your new key.';
      73  $string['exportfields'] = 'Fields to export';
      74  $string['failedaclwrite'] = 'Failed to write to the MNet access control list for user \'{$a}\'.';
      75  $string['findlogin'] = 'Find login';
      76  $string['forbidden-function'] = 'That function has not been enabled for RPC.';
      77  $string['forbidden-transport'] = 'The transport method you are trying to use is not permitted.';
      78  $string['forcesavechanges'] = 'Force save changes';
      79  $string['helpnetworksettings'] = 'Configure MNet communication';
      80  $string['hidelocal'] = 'Hide local users';
      81  $string['hideremote'] = 'Hide remote users';
      82  $string['host'] = 'host';
      83  $string['hostcoursenotfound'] = 'Host or course not found';
      84  $string['hostdeleted'] = 'Host deleted';
      85  $string['hostexists'] = 'A record already exists for a host with that hostname (it may be deleted). <a href="{$a}">click here</a> to edit that record.';
      86  $string['hostlist'] = 'List of networked hosts';
      87  $string['hostname'] = 'Hostname';
      88  $string['hostnamehelp'] = 'The fully-qualified domain name of the remote host, e.g.';
      89  $string['hostnotconfiguredforsso'] = 'This server is not configured for remote login.';
      90  $string['hostsettings'] = 'Host settings';
      91  $string['http_self_signed_help'] = 'Permit connections using a self-signed DIY SSL certificate on the remote host.';
      92  $string['https_self_signed_help'] = 'Permit connections using a self-signed DIY SSL in PHP on the remote host over http.';
      93  $string['https_verified_help'] = 'Permit connections using a verified SSL certificate on the remote host.';
      94  $string['http_verified_help'] = 'Permit connections using a verified SSL certificate in PHP on the remote host, but over http (not https).';
      95  $string['id'] = 'ID';
      96  $string['idhelp'] = 'This value is automatically assigned and cannot be changed';
      97  $string['importfields'] = 'Fields to import';
      98  $string['inspect'] = 'Inspect';
      99  $string['installnosuchfunction'] = 'Coding error! Something is trying to install a mnet xmlrpc function ({$a->method}) from a file ({$a->file}) and it can\'t be found!';
     100  $string['installnosuchmethod'] = 'Coding error! Something is trying to install a mnet xmlrpc method ({$a->method}) on a class ({$a->class}) and it can\'t be found!';
     101  $string['installreflectionclasserror'] = 'Coding error! MNet introspection failed for method \'{$a->method}\' in class \'{$a->class}\'.  The original error message, in case it helps, is: \'{$a->error}\'';
     102  $string['installreflectionfunctionerror'] = 'Coding error! MNet introspection failed for function \'{$a->method}\' in file \'{$a->file}\'.  The original error message, in case it helps, is: \'{$a->error}\'';
     103  $string['invalidaccessparam'] = 'Invalid access parameter.';
     104  $string['invalidactionparam'] = 'Invalid action parameter.';
     105  $string['invalidhost'] = 'You must provide a valid host identifier';
     106  $string['invalidpubkey'] = 'The key is not a valid SSL key. ({$a})';
     107  $string['invalidurl'] = 'Invalid URL parameter.';
     108  $string['ipaddress'] = 'IP address';
     109  $string['is_in_range'] = 'The IP address <code>{$a}</code> represents a valid trusted host.';
     110  $string['ispublished'] = '{$a} has enabled this service for you.';
     111  $string['issubscribed'] = '{$a} is subscribing to this service on your host.';
     112  $string['keydeleted'] = 'Your key has been successfully deleted and replaced.';
     113  $string['keymismatch'] = 'The public key you are holding for this host is different from the public key it is currently publishing. The currently published key is:';
     114  $string['last_connect_time'] = 'Last connect time';
     115  $string['last_connect_time_help'] = 'The time that you last connected to this host.';
     116  $string['last_transport_help'] = 'The transport that you used for the last connection to this host.';
     117  $string['leavedefault'] = 'Use the default settings instead';
     118  $string['listservices'] = 'List services';
     119  $string['loginlinkmnetuser'] = '<br />If you are MNet remote user and can <a href="{$a}">confirm your email address here</a>, you can be redirected to your login page.<br />';
     120  $string['logs'] = 'logs';
     121  $string['managemnetpeers'] = 'Manage peers';
     122  $string['method'] = 'Method';
     123  $string['methodhelp'] = 'Method help for {$a}';
     124  $string['methodsavailableonhost'] = 'Methods available on {$a}';
     125  $string['methodsavailableonhostinservice'] = 'Methods available for {$a->service} on {$a->host}';
     126  $string['methodsignature'] = 'Method signature for {$a}';
     127  $string['mnet'] = 'MNet';
     128  $string['mnet_concatenate_strings'] = 'Concatenate (up to) 3 strings and return the result';
     129  $string['mnetdisabled'] = 'MNet is <strong>disabled</strong>.';
     130  $string['mnetidprovider'] = 'MNet ID provider';
     131  $string['mnetidproviderdesc'] = 'You can use this facility to retrieve a link that you can log in at, if you can provide the correct email address to match the username you previously tried to log in with.';
     132  $string['mnetidprovidermsg'] = 'You should be able to login at your {$a} provider.';
     133  $string['mnetidprovidernotfound'] = 'Sorry, but no further information could be found.';
     134  $string['mnetpeers'] = 'Peers';
     135  $string['mnetservices'] = 'Services';
     136  $string['mnet_session_prohibited'] = 'Users from your home server are not currently permitted to roam to {$a}.';
     137  $string['mnetsettings'] = 'MNet settings';
     138  $string['moodle_home_help'] = 'The path to the homepage of MNet application on the remote host, e.g. /moodle/.';
     139  $string['name'] = 'Name';
     140  $string['net'] = 'Networking';
     141  $string['networksettings'] = 'Network settings';
     142  $string['never'] = 'Never';
     143  $string['noaclentries'] = 'No entries in the SSO access control list';
     144  $string['noaddressforhost'] = 'Sorry, but that hostname ({$a}) could not be resolved!';
     145  $string['nocurl'] = 'PHP cURL library is not installed';
     146  $string['nolocaluser'] = 'No local record exists for remote user, and it could not be created, as this host will not auto create users.  Please contact your administrator!';
     147  $string['nomodifyacl'] = 'You are not permitted to modify the MNet access control list.';
     148  $string['nonmatchingcert'] = 'The subject of the certificate: <br /><em>{$a->subject}</em><br />does not match the host it came from:<br /><em>{$a->host}</em>.';
     149  $string['nopubkey'] = 'There was a problem retrieving the public key.<br />Maybe the host does not allow MNet or the key is invalid.';
     150  $string['nosite'] = 'Could not find site-level course';
     151  $string['nosuchfile'] = 'The file/function {$a} does not exist.';
     152  $string['nosuchfunction'] = 'Unable to locate function, or function prohibited for RPC.';
     153  $string['nosuchmodule'] = 'The function was incorrectly addressed and could not be located. Please use the
     154  mod/modulename/lib/functionname format.';
     155  $string['nosuchpublickey'] = 'Unable to obtain public key for signature verification.';
     156  $string['nosuchservice'] = 'The RPC service is not running on this host.';
     157  $string['nosuchtransport'] = 'No transport with that ID exists.';
     158  $string['notBASE64'] = 'This string is not in base64 encoded format. It cannot be a valid key.';
     159  $string['notenoughidpinfo'] = 'Your identity provider is not giving us enough information to create or update your account locally. Sorry!';
     160  $string['not_in_range'] = 'The IP address <code>{$a}</code> does not represent a valid trusted host.';
     161  $string['notinxmlrpcserver'] = 'Attempt to access the MNet remote client, not during XMLRPC server execution';
     162  $string['notmoodleapplication'] = 'WARNING: This is not a Moodle application, so some of the inspection methods may not work properly.';
     163  $string['notPEM'] = 'This key is not in PEM format. It will not work.';
     164  $string['notpermittedtojump'] = 'You do not have permission to begin a remote session from this Moodle server.';
     165  $string['notpermittedtojumpas'] = 'You can\'t begin a remote session while you are logged in as another user.';
     166  $string['notpermittedtoland'] = 'You do not have permission to begin a remote session.';
     167  $string['off'] = 'Off';
     168  $string['on'] = 'On';
     169  $string['options'] = 'Options';
     170  $string['peerprofilefielddesc'] = 'Here you can override the global settings for which profile fields to send and import when new users are created';
     171  $string['permittedtransports'] = 'Permitted transports';
     172  $string['phperror'] = 'An internal PHP error prevented your request being fulfilled.';
     173  $string['position'] = 'Position';
     174  $string['postrequired'] = 'The delete function requires a POST request.';
     175  $string['privacy:metadata'] = 'The MNet plugin does not store any personal data.';
     176  $string['profileexportfields'] = 'Fields to send';
     177  $string['profilefielddesc'] = 'Here you can configure the list of profile fields that are sent and received over MNet when user accounts are created, or updated.  You can also override this for each MNet peer individually. Note that the following fields are always sent and are not optional: {$a}';
     178  $string['profilefields'] = 'Profile fields';
     179  $string['profileimportfields'] = 'Fields to import';
     180  $string['promiscuous'] = 'Promiscuous';
     181  $string['publickey'] = 'Public key';
     182  $string['publickey_help'] = 'The public key is automatically obtained from the remote server.';
     183  $string['publickeyrequired'] = 'You must provide a public key.';
     184  $string['publish'] = 'Publish';
     185  $string['reallydeleteserver'] = 'Are you sure you want to delete the server?';
     186  $string['receivedwarnings'] = 'The following warnings were received';
     187  $string['recordnoexists'] = 'Record does not exist.';
     188  $string['reenableserver'] = 'No - select this option to re-enable this server.';
     189  $string['registerallhosts'] = 'Register all hosts (promiscuous mode)';
     190  $string['registerallhostsexplain'] = 'You can choose to register all hosts that try to connect to you automatically. This means that a record will appear in your hosts list for any MNet site that connects to you and requests your public key.<br />You have the option below to configure services for \'All hosts\' and by enabling some services there, you are able to provide services to any remote server indiscriminately.';
     191  $string['registerhostsoff'] = 'Register all hosts is currently <b>off</b>';
     192  $string['registerhostson'] = 'Register all hosts is currently <b>on</b>';
     193  $string['remotecourses'] = 'Remote courses';
     194  $string['remotehost'] = 'Remote host';
     195  $string['remotehosts'] = 'Remote hosts';
     196  $string['remoteuser'] = 'Remote {$a->remotetype} user';
     197  $string['remoteuserinfo'] = 'Profile fetched from <a href="{$a->remoteurl}">{$a->remotename}</a>';
     198  $string['requiresopenssl'] = 'Networking requires the OpenSSL extension';
     199  $string['restore'] = 'Restore';
     200  $string['returnvalue'] = 'Return value';
     201  $string['reviewhostdetails'] = 'Review host details';
     202  $string['reviewhostservices'] = 'Review host services';
     203  $string['RPC_HTTP_PLAINTEXT'] = 'HTTP unencrypted';
     204  $string['RPC_HTTP_SELF_SIGNED'] = 'HTTP (self-signed)';
     205  $string['RPC_HTTPS_SELF_SIGNED'] = 'HTTPS (self-signed)';
     206  $string['RPC_HTTPS_VERIFIED'] = 'HTTPS (signed)';
     207  $string['RPC_HTTP_VERIFIED'] = 'HTTP (signed)';
     208  $string['selectaccesslevel'] = 'Please select an access level from the list.';
     209  $string['selectahost'] = 'Please select a remote host.';
     210  $string['service'] = 'Service name';
     211  $string['serviceid'] = 'Service ID';
     212  $string['servicesavailableonhost'] = 'Services available on {$a}';
     213  $string['serviceswepublish'] = 'Services we publish to {$a}.';
     214  $string['serviceswesubscribeto'] = 'Services on {$a} that we subscribe to.';
     215  $string['settings'] = 'Settings';
     216  $string['showlocal'] = 'Show local users';
     217  $string['showremote'] = 'Show remote users';
     218  $string['ssl_acl_allow'] = 'SSO ACL: Allow user \'{$a->user}\' from \'{$a->host}\'';
     219  $string['ssl_acl_deny'] = 'SSO ACL: Deny user \'{$a->user}\' from \'{$a->host}\'';
     220  $string['sslverification'] = 'SSL verification';
     221  $string['sslverification_help'] = 'This option allows you to configure the level of security when connecting to a peer using HTTPS.
     223  * None: no level of security
     224  * Verify host only: validates the domain of the SSL certificate
     225  * Verify host and peer (recommended): validates the domain and issuer of the SSL certificate';
     226  $string['ssoaccesscontrol'] = 'SSO access control';
     227  $string['ssoacldescr'] = 'Use this page to grant/deny access to specific users from remote MNet hosts. This is functional when you are offering SSO services to remote users. To control your <em>local</em> users\' ability to roam to other MNet hosts, use the roles system to grant them the <em>mnetlogintoremote</em> capability.';
     228  $string['ssoaclneeds'] = 'For this functionality to work, you must have Networking on, plus the MNet authentication plugin enabled.';
     229  $string['strict'] = 'Strict';
     230  $string['subscribe'] = 'Subscribe';
     231  $string['system'] = 'System';
     232  $string['testclient'] = 'MNet test client';
     233  $string['testtrustedhosts'] = 'Test an address';
     234  $string['testtrustedhostsexplain'] = 'Enter an IP address to see if it is a trusted host.';
     235  $string['theypublish'] = 'They publish';
     236  $string['theysubscribe'] = 'They subscribe';
     237  $string['transport_help'] = 'These options are reciprocal, so you can only force a remote host to use a signed SSL cert if your server also has a signed SSL cert.';
     238  $string['trustedhosts'] = 'XML-RPC hosts';
     239  $string['trustedhostsexplain'] = '<p>The trusted hosts mechanism allows specific machines to execute calls via XML-RPC to any part of the Moodle API. This is available for scripts to control Moodle behaviour and can be a very dangerous option to enable. If in doubt, keep it off.</p>
     240  <p><strong>This is not needed for any standard MNet feature!</strong> Turn it on only if you know what you are doing.</p>
     241  <p>To enable it, enter a list of IP addresses or networks,
     242  one on each line. Some examples:</p>
     243  Your local host:<br /><br />Your local host (with a network block):<br /><br />Only the host with IP address<br /><br />Any host with an IP address between and<br /><br />Any host whatsoever:<br /><br />Obviously the last example is <strong>not</strong> a recommended configuration.';
     244  $string['turnitoff'] = 'Turn it off';
     245  $string['turniton'] = 'Turn it on';
     246  $string['type'] = 'Type';
     247  $string['unknown'] = 'Unknown';
     248  $string['unknownerror'] = 'Unknown error occurred during negotiation.';
     249  $string['usercannotchangepassword'] = 'You cannot change your password here since you are a remote user.';
     250  $string['userchangepasswordlink'] = '<br /> You may be able to change your password at your <a href="{$a->wwwroot}/login/change_password.php">{$a->description}</a> provider.';
     251  $string['usernotfullysetup'] = 'Your user account is incomplete.  You need to go <a href="{$a}">back to your provider</a> and ensure your profile is completed there.  You may need to log out and in again for this to take effect.';
     252  $string['usersareonline'] = 'Warning: {$a} users from that server are currently logged on to your site.';
     253  $string['validated_by'] = 'It is validated by the network: <code>{$a}</code>';
     254  $string['verifyhostandpeer'] = 'Verify host and peer';
     255  $string['verifyhostonly'] = 'Verify host only';
     256  $string['verifysignature-error'] = 'The signature verification failed. An error has occurred.';
     257  $string['verifysignature-invalid'] = 'The signature verification failed. It appears that this payload was not signed by you.';
     258  $string['version'] = 'Version';
     259  $string['warning'] = 'Warning';
     260  $string['wrong-ip'] = 'Your IP address does not match the address we have on record.';
     261  $string['xmlrpc-missing'] = 'You must have XML-RPC installed in your PHP build to be able to use this feature.';
     262  $string['yourhost'] = 'Your host';
     263  $string['yourpeers'] = 'Your peers';