7 * Purpose: Handles communication associated with the issuance of
12 if(! function_exists('dfrn_request_init')) {
13 function dfrn_request_init(&$a) {
18 profile_load($a,$which);
24 * Function: dfrn_request_post
27 * Handles multiple scenarios.
30 * Clicking 'submit' on a friend request page.
33 * Following Scenario 1, we are brought back to our home site
34 * in order to link our friend request with our own server cell.
35 * After logging in, we click 'submit' to approve the linkage.
39 if(! function_exists('dfrn_request_post')) {
40 function dfrn_request_post(&$a) {
42 if(($a->argc != 2) || (! count($a->profile)))
46 if($_POST['cancel']) {
47 goaway($a->get_baseurl());
53 * Scenario 2: We've introduced ourself to another cell, then have been returned to our own cell
54 * to confirm the request, and then we've clicked submit (perhaps after logging in).
55 * That brings us here:
59 if((x($_POST,'localconfirm')) && ($_POST['localconfirm'] == 1)) {
62 * Ensure this is a valid request
65 if(local_user() && ($a->user['nickname'] == $a->argv[1]) && (x($_POST,'dfrn_url'))) {
68 $dfrn_url = notags(trim($_POST['dfrn_url']));
69 $aes_allow = (((x($_POST,'aes_allow')) && ($_POST['aes_allow'] == 1)) ? 1 : 0);
70 $confirm_key = ((x($_POST,'confirm_key')) ? $_POST['confirm_key'] : "");
72 $contact_record = null;
77 * Lookup the contact based on their URL (which is the only unique thing we have at the moment)
80 $r = q("SELECT * FROM `contact` WHERE `uid` = %d AND `url` = '%s' AND `self` = 0 LIMIT 1",
86 if(strlen($r[0]['dfrn-id'])) {
89 * We don't need to be here. It has already happened.
92 notice( t("This introduction has already been accepted.") . EOL );
96 $contact_record = $r[0];
99 if(is_array($contact_record)) {
100 $r = q("UPDATE `contact` SET `ret-aes` = %d WHERE `id` = %d LIMIT 1",
102 intval($contact_record['id'])
108 * Scrape the other site's profile page to pick up the dfrn links, key, fn, and photo
111 require_once('Scrape.php');
113 $parms = scrape_dfrn($dfrn_url);
115 if(! count($parms)) {
116 notice( t('Profile location is not valid or does not contain profile information.') . EOL );
121 notice( t('Warning: profile location has no identifiable owner name.') . EOL );
122 if(! x($parms,'photo'))
123 notice( t('Warning: profile location has no profile photo.') . EOL );
124 $invalid = validate_dfrn($parms);
126 notice( sprintf( tt("%d required parameter was not found at the given location",
127 "%d required parameters were not found at the given location",
128 $invalid), $invalid) . EOL );
133 $dfrn_request = $parms['dfrn-request'];
135 /********* Escape the entire array ********/
139 /******************************************/
142 * Create a contact record on our site for the other person
145 $r = q("INSERT INTO `contact` ( `uid`, `created`,`url`, `name`, `nick`, `photo`, `site-pubkey`,
146 `request`, `confirm`, `notify`, `poll`, `aes_allow`)
147 VALUES ( %d, '%s', '%s', '%s' , '%s', '%s', '%s', '%s', '%s', '%s', '%s', %d)",
148 intval(local_user()),
155 $parms['dfrn-request'],
156 $parms['dfrn-confirm'],
157 $parms['dfrn-notify'],
164 notice( t("Introduction complete.") . EOL);
168 * Allow the blocked remote notification to complete
171 if(is_array($contact_record))
172 $dfrn_request = $contact_record['request'];
174 if(strlen($dfrn_request) && strlen($confirm_key))
175 $s = fetch_url($dfrn_request . '?confirm_key=' . $confirm_key);
177 // (ignore reply, nothing we can do it failed)
180 return; // NOTREACHED
186 // invalid/bogus request
188 notice( t('Unrecoverable protocol error.') . EOL );
189 goaway($a->get_baseurl());
190 return; // NOTREACHED
197 * We are the requestee. A person from a remote cell has made an introduction
198 * on our profile web page and clicked submit. We will use their DFRN-URL to
199 * figure out how to contact their cell.
201 * Scrape the originating DFRN-URL for everything we need. Create a contact record
202 * and an introduction to show our user next time he/she logs in.
203 * Finally redirect back to the requestor so that their site can record the request.
204 * If our user (the requestee) later confirms this request, a record of it will need
205 * to exist on the requestor's cell in order for the confirmation process to complete..
207 * It's possible that neither the requestor or the requestee are logged in at the moment,
208 * and the requestor does not yet have any credentials to the requestee profile.
210 * Who is the requestee? We've already loaded their profile which means their nickname should be
211 * in $a->argv[1] and we should have their complete info in $a->profile.
215 if(! (is_array($a->profile) && count($a->profile))) {
216 notice( t('Profile unavailable.') . EOL);
220 $nickname = $a->profile['nickname'];
221 $notify_flags = $a->profile['notify-flags'];
222 $uid = $a->profile['uid'];
223 $maxreq = intval($a->profile['maxreq']);
224 $contact_record = null;
229 if( x($_POST,'dfrn_url')) {
232 * Block friend request spam
236 $r = q("SELECT * FROM `intro` WHERE `datetime` > '%s' AND `uid` = %d",
237 dbesc(datetime_convert('UTC','UTC','now - 24 hours')),
240 if(count($r) > $maxreq) {
241 notice( sprintf( t('%s has received too many connection requests today.'), $a->profile['name']) . EOL);
242 notice( t('Spam protection measures have been invoked.') . EOL);
243 notice( t('Friends are advised to please try again in 24 hours.') . EOL);
250 * Cleanup old introductions that remain blocked.
251 * Also remove the contact record, but only if there is no existing relationship
255 $r = q("SELECT `intro`.*, `intro`.`id` AS `iid`, `contact`.`id` AS `cid`, `contact`.`rel`
256 FROM `intro` LEFT JOIN `contact` on `intro`.`contact-id` = `contact`.`id`
257 WHERE `intro`.`blocked` = 1 AND `contact`.`self` = 0 AND `intro`.`datetime` < UTC_TIMESTAMP() - INTERVAL 30 MINUTE ");
261 q("DELETE FROM `contact` WHERE `id` = %d LIMIT 1",
265 q("DELETE FROM `intro` WHERE `id` = %d LIMIT 1",
271 $url = trim($_POST['dfrn_url']);
273 notice( t("Invalid locator") . EOL );
277 // Canonicalise email-style profile locator
279 $url = webfinger_dfrn($url);
281 if(substr($url,0,5) === 'stat:') {
283 $url = substr($url,5);
289 logger('dfrn_request: url: ' . $url);
292 notice( t("Unable to resolve your name at the provided location.") . EOL);
297 if($network === 'dfrn') {
298 $ret = q("SELECT * FROM `contact` WHERE `uid` = %d AND `url` = '%s' AND `self` = 0 LIMIT 1",
304 if(strlen($ret[0]['issued-id'])) {
305 notice( t('You have already introduced yourself here.') . EOL );
308 elseif($ret[0]['rel'] == REL_BUD) {
309 notice( sprintf( t('Apparently you are already friends with %s.'), $a->profile['name']) . EOL);
313 $contact_record = $ret[0];
314 $parms = array('dfrn-request' => $ret[0]['request']);
318 $issued_id = random_string();
320 if(is_array($contact_record)) {
321 // There is a contact record but no issued-id, so this
322 // is a reciprocal introduction from a known contact
323 $r = q("UPDATE `contact` SET `issued-id` = '%s' WHERE `id` = %d LIMIT 1",
325 intval($contact_record['id'])
329 if(! validate_url($url)) {
330 notice( t('Invalid profile URL.') . EOL);
331 goaway($a->get_baseurl() . '/' . $a->cmd);
332 return; // NOTREACHED
335 if(! allowed_url($url)) {
336 notice( t('Disallowed profile URL.') . EOL);
337 goaway($a->get_baseurl() . '/' . $a->cmd);
338 return; // NOTREACHED
342 require_once('Scrape.php');
344 $parms = scrape_dfrn($url);
346 if(! count($parms)) {
347 notice( t('Profile location is not valid or does not contain profile information.') . EOL );
348 goaway($a->get_baseurl() . '/' . $a->cmd);
352 notice( t('Warning: profile location has no identifiable owner name.') . EOL );
353 if(! x($parms,'photo'))
354 notice( t('Warning: profile location has no profile photo.') . EOL );
355 $invalid = validate_dfrn($parms);
357 notice( sprintf( tt("%d required parameter was not found at the given location",
358 "%d required parameters were not found at the given location",
359 $invalid), $invalid) . EOL );
366 $parms['url'] = $url;
367 $parms['issued-id'] = $issued_id;
371 $r = q("INSERT INTO `contact` ( `uid`, `created`, `url`, `name`, `nick`, `issued-id`, `photo`, `site-pubkey`,
372 `request`, `confirm`, `notify`, `poll` )
373 VALUES ( %d, '%s', '%s', '%s', '%s', '%s', '%s', '%s', '%s', '%s', '%s', '%s' )",
382 $parms['dfrn-request'],
383 $parms['dfrn-confirm'],
384 $parms['dfrn-notify'],
388 // find the contact record we just created
390 $r = q("SELECT `id` FROM `contact`
391 WHERE `uid` = %d AND `url` = '%s' AND `issued-id` = '%s' LIMIT 1",
397 $contact_record = $r[0];
402 notice( t('Failed to update contact record.') . EOL );
406 $hash = random_string() . (string) time(); // Generate a confirm_key
408 if(is_array($contact_record)) {
409 $ret = q("INSERT INTO `intro` ( `uid`, `contact-id`, `blocked`, `knowyou`, `note`, `hash`, `datetime`)
410 VALUES ( %d, %d, 1, %d, '%s', '%s', '%s' )",
412 intval($contact_record['id']),
413 ((x($_POST,'knowyou') && ($_POST['knowyou'] == 1)) ? 1 : 0),
414 dbesc(notags(trim($_POST['dfrn-request-message']))),
416 dbesc(datetime_convert())
420 // This notice will only be seen by the requestor if the requestor and requestee are on the same server.
423 notice( t('Your introduction has been sent.') . EOL );
425 // "Homecoming" - send the requestor back to their site to record the introduction.
427 $dfrn_url = bin2hex($a->get_baseurl() . '/profile/' . $nickname);
428 $aes_allow = ((function_exists('openssl_encrypt')) ? 1 : 0);
430 goaway($parms['dfrn-request'] . "?dfrn_url=$dfrn_url"
431 . '&dfrn_version=' . DFRN_PROTOCOL_VERSION
432 . '&confirm_key=' . $hash
433 . (($aes_allow) ? "&aes_allow=1" : "")
436 // END $network === 'dfrn'
438 elseif($network === 'stat') {
443 * Check contact existence
444 * Try and scrape together enough information to create a contact record, with us as REL_VIP
445 * Substitute our user's feed URL into $url template
446 * Send the subscriber home to subscribe
450 $url = str_replace('{uri}', $a->get_baseurl() . '/dfrn_poll/' . $nickname, $url);
453 // END $network === 'stat'
462 if(! function_exists('dfrn_request_content')) {
463 function dfrn_request_content(&$a) {
467 if(($a->argc != 2) || (! count($a->profile)))
471 // "Homecoming". Make sure we're logged in to this site as the correct user. Then offer a confirm button
472 // to send us to the post section to record the introduction.
474 if(x($_GET,'dfrn_url')) {
477 notice( t("Please login to confirm introduction.") . EOL );
479 /* setup the return URL to come back to this page if they use openid */
481 $stripped = str_replace('q=','',$a->query_string);
482 $_SESSION['return_url'] = trim($stripped,'/');
487 // Edge case, but can easily happen in the wild. This person is authenticated,
488 // but not as the person who needs to deal with this request.
490 if ($a->user['nickname'] != $a->argv[1]) {
491 notice( t("Incorrect identity currently logged in. Please login to <strong>this</strong> profile.") . EOL);
495 $dfrn_url = notags(trim(hex2bin($_GET['dfrn_url'])));
496 $aes_allow = (((x($_GET,'aes_allow')) && ($_GET['aes_allow'] == 1)) ? 1 : 0);
497 $confirm_key = (x($_GET,'confirm_key') ? $_GET['confirm_key'] : "");
498 $o .= load_view_file("view/dfrn_req_confirm.tpl");
499 $o = replace_macros($o,array(
500 '$dfrn_url' => $dfrn_url,
501 '$aes_allow' => (($aes_allow) ? '<input type="hidden" name="aes_allow" value="1" />' : "" ),
502 '$confirm_key' => $confirm_key,
503 '$welcome' => sprintf( t('Welcome home %s.'), $a->user['username']),
504 '$please' => sprintf( t('Please confirm your introduction/connection request to %s.'), $dfrn_url),
505 '$submit' => t('Confirm'),
506 '$uid' => $_SESSION['uid'],
507 '$nickname' => $a->user['nickname'],
508 'dfrn_rawurl' => $_GET['dfrn_url']
513 elseif((x($_GET,'confirm_key')) && strlen($_GET['confirm_key'])) {
515 // we are the requestee and it is now safe to send our user their introduction,
516 // We could just unblock it, but first we have to jump through a few hoops to
517 // send an email, or even to find out if we need to send an email.
519 $intro = q("SELECT * FROM `intro` WHERE `hash` = '%s' LIMIT 1",
520 dbesc($_GET['confirm_key'])
525 $r = q("SELECT `contact`.*, `user`.* FROM `contact` LEFT JOIN `user` ON `contact`.`uid` = `user`.`uid`
526 WHERE `contact`.`id` = %d LIMIT 1",
527 intval($intro[0]['contact-id'])
530 $auto_confirm = false;
533 if($r[0]['page-flags'] != PAGE_NORMAL)
534 $auto_confirm = true;
535 if(($r[0]['notify-flags'] & NOTIFY_INTRO) && (! $auto_confirm)) {
536 $email_tpl = load_view_file('view/request_notify_eml.tpl');
537 $email = replace_macros($email_tpl, array(
538 '$requestor' => ((strlen(stripslashes($r[0]['name']))) ? stripslashes($r[0]['name']) : t('[Name Withheld]')),
539 '$url' => stripslashes($r[0]['url']),
540 '$myname' => $r[0]['username'],
541 '$siteurl' => $a->get_baseurl(),
542 '$sitename' => $a->config['sitename']
544 $res = mail($r[0]['email'],
545 t("Introduction received at ") . $a->config['sitename'],
547 'From: ' . t('Administrator') . '@' . $_SERVER['SERVER_NAME'] . "\n"
548 . 'Content-type: text/plain; charset=UTF-8' . "\n"
549 . 'Content-transfer-encoding: 8bit' );
551 // This is a redundant notification - no point throwing errors if it fails.
554 require_once('mod/dfrn_confirm.php');
556 'uid' => $r[0]['uid'],
557 'node' => $r[0]['nickname'],
558 'dfrn_id' => $r[0]['issued-id'],
559 'intro_id' => $intro[0]['id'],
560 'duplex' => (($r[0]['page-flags'] == PAGE_FREELOVE) ? 1 : 0)
562 dfrn_confirm_post($a,$handsfree);
567 if(! $auto_confirm) {
569 // If we are auto_confirming, this record will have already been nuked
570 // in dfrn_confirm_post()
572 $r = q("UPDATE `intro` SET `blocked` = 0 WHERE `hash` = '%s' LIMIT 1",
573 dbesc($_GET['confirm_key'])
578 return; // NOTREACHED
583 * Normal web request. Display our user's introduction form.
587 * Try to auto-fill the profile address
591 if(strlen($a->path)) {
592 $myaddr = $a->get_baseurl() . '/profile/' . $a->user['nickname'];
595 $myaddr = $a->user['nickname'] . '@' . substr($a->get_baseurl(), strpos($a->get_baseurl(),'://') + 3 );
598 elseif(x($_GET,'addr')) {
599 $myaddr = hex2bin($_GET['addr']);
602 /* $_GET variables are already urldecoded */
603 $myaddr = ((x($_GET,'address')) ? $_GET['address'] : '');
608 * The auto_request form only has the profile address
609 * because nobody is going to read the comments and
610 * it doesn't matter if they know you or not.
614 if($a->profile['page-flags'] == PAGE_NORMAL)
615 $tpl = load_view_file('view/dfrn_request.tpl');
617 $tpl = load_view_file('view/auto_request.tpl');
619 $o .= replace_macros($tpl,array(
620 '$header' => t('Friend/Connection Request'),
621 '$desc' => t('Examples: jojo@demo.friendika.com, http://demo.friendika.com/profile/jojo, testuser@identi.ca'),
622 '$pls_answer' => t('Please answer the following:'),
623 '$does_know' => t('Does $name know you?'),
626 '$add_note' => t('Add a personal note:'),
627 '$page_desc' => t("Please enter your 'Identity Address' from one of the following supported social networks:"),
628 '$friendika' => t('Friendika'),
629 '$statusnet' => t('StatusNet/Federated Social Web'),
630 '$private_net' => t("Private \x28secure\x29 network"),
631 '$public_net' => t("Public \x28insecure\x29 network"),
632 '$your_address' => t('Your Identity Address:'),
633 '$submit' => t('Submit Request'),
634 '$cancel' => t('Cancel'),
635 '$nickname' => $a->argv[1],
636 '$name' => $a->profile['name'],
642 return; // Somebody is fishing.