aboutsummaryrefslogblamecommitdiffstats
path: root/Zotlabs/Module/Import.php
blob: 7aed6469eae7292f96c2218a0a721aea8a211176 (plain) (tree)
1
2
3
4
5
6
7
8
9
     
 

                         
                                    
                                   
                                         
 
        
           
                          
                       
                       
                           
 
 





                                                        
                                 
 




                                              
                                              
 
                                   
                                                         

                               
 



                                                                                                         
                                                                                                         





                                                                       
 
                                           
                           



                                                                                            

                                                            

                                                                                  
 
                                        



                                                                 

                                                     


                                                                                                       
                                                             
                                                                      
                                       

                                                               
                                                                                                                                                                                                           
                                                                                     
                         
 
                                                                                        
                                                                                              
 
                                                                                          
                                                                                           

                                                                

                                                                                           



                                                                                       
 
                                           
                                       

                                                                                        
                                              
                                                     

                              
                                                                                           

                                       
                 
 
                             
                                                     
                                                                   

                               
 
                                                 
 

                                                                 
 


                                                                         
                                       
                 
 









                                                                                                                                                   
 


                                                                                    
                                                                         



                                                                                          
                                                                                        



                                                                                                               
 
                            
                                   
 
                                 
 
                                                                                               
 
                                                         
 
                                                                                                       
 
                                                        
                                                                                                                              

                                                           

                                                                                                                                



                                               

                                           
 
                                                                                 

                                                                             
 
                                                               
                                                                                         




                                                                                                   


                                         
                                                      
                 
 


                                                                               

                               
 





                                                                                                                   

                                                                 
                 
 
                                        
 

                                                         
                                                                               
                                                                                                                                                            
                         
 

                                                                            
                 
 
                                        
 
                                                                     
 
                                                         
 
                                                   
 

                                                   
                                                                                      
                                                                                          






                                                                                                                
                                                                               
                                                                                             

                                                                                   
                                                                                                                               



                                                                                  
                                     



                                                                                                                                                      

                         
                 
 
                                        
 
                                                   
 
                                                                   
 
                                                                                                       
 

                                                                           
                          
 

                                                  












                                                                                                                      
                                                                                 
                                                                                

                                 
 
                 
 
                                        
 
                                
                                         

                                                     
 



                                                                                                                       

                                                         
                                 
 
                                                                                


                                                                                                                  
                                                                                                                  


                                                                                                                  
                                 
 


                                                                                                      
                                       
                                                 
 
                                                                         
 
                                                                               
 
                                                                                        





                                                                                                                                                           

                                      

                                                                                                                    



                                                                                        
                                                                                                                                                                                                            







                                                                           
                         
 





                                                              

                                                                                   
                 
 
                             
                             
 

                                         

                                                     
 
                                                     
 
                                                 
                                                                                                                                      
                                                                       
 





                                                                   
                                                                
 

                                                                                 
                                                                                 




                                                                                                                 
                                                                                                                 

                                                                                                                 
                                 
 
                                                                                                                                                                     
                                                                     
                                 
 


                                                                                                                  


                                                                                                                 
                                         

                                      
                                                                                              
                                                         
                                                                                                                          

                                                         
 



                                                                                                                            


                                                                                                                                                         





                                                                                      

                                      
                                                                     
 


                                                                         
                                 
 
                                                                                     
 
                                                
                                                                                       

                                                                                                                                       
                                         

                                 
 
                                                
                 
 
 
                                
                                         
                              
                                    
                                                     
                                                                                 
                                                                       

                                                                         
                                 


                                                                       
                                                                        
                         
                                                                   

                                                              

                                                     

                                                                               
                         
                 
 
                                       
                                                       

                                                                   

                                                                              

                                                                              
                                                                                 
                                 
                                                                                      
                         
                 

                                        
 
 

                                                            
 

                                                               
 

                                                            
 

                                                                  
 

                                                                      
 

                                                                
 

                                                                                      
 

                                                              
 

                                                                                
 

                                                                                    
 
                                                                  
                                                     
 
                                                                                        
                                                                                


                                                                    
                                                                                    

                                                                                        
                                                                      
 


                                                       
                                                
 




                                                                                                                                   
 
                                       
 


                                                                                                                 
 

                                                                                                                                        
 
                                                                                             
                                          
 

                                                                                                                                                               
                         
                 
 
                                                       
 
                                                                   
                                                              

                 
                                                       
                                                                                                                                                                            
                 
 
                                 
 
         



                                                            
                         
                                               
                                 
                               
 

                                                                                     

                                                   





                                               
                        
 

                                                                                      

                                  
 

                                                   


                                                                                                                                                                                                                                    
                                                                 
                                                                                        
 


                                                                                                                     
                                                                                                                                                            
 
                                                                                                                                                                                                                                                                                                                      
 
                                                                                                                                    

                                                                                                                                                                                                                                                                                    
 
                                                                                                                                                                           
 
                                                                                            

                                                             
 
                          
         
 
 
<?php

namespace Zotlabs\Module;

require_once('include/channel.php');
require_once('include/import.php');
require_once('include/perm_upgrade.php');

use App;
use URLify;
use Zotlabs\Daemon\Master;
use Zotlabs\Lib\Config;
use Zotlabs\Lib\Libzot;
use Zotlabs\Web\Controller;


/**
 * @brief Module for channel import.
 *
 * Import a channel, either by direct file upload or via
 * connection to another server.
 */
class Import extends Controller {

	/**
	 * @brief Import channel into account.
	 *
	 * @param int $account_id
	 */
	function import_account($account_id) {

		if (!$account_id) {
			logger('No account ID supplied');
			return;
		}

		$max_friends  = account_service_class_fetch($account_id, 'total_channels');
		$max_feeds    = account_service_class_fetch($account_id, 'total_feeds');
		$data         = null;
		$seize        = ((x($_REQUEST, 'make_primary')) ? intval($_REQUEST['make_primary']) : 0);
		$import_posts = ((x($_REQUEST, 'import_posts')) ? intval($_REQUEST['import_posts']) : 0);
		$moving       = false; //intval($_REQUEST['moving']);
		$src          = $_FILES['filename']['tmp_name'];
		$filename     = basename($_FILES['filename']['name']);
		$filesize     = intval($_FILES['filename']['size']);
		$filetype     = $_FILES['filename']['type'];
		$newname      = trim(strtolower($_REQUEST['newname']));

		// import channel from file
		if ($src) {

			// This is OS specific and could also fail if your tmpdir isn't very
			// large mostly used for Diaspora which exports gzipped files.

			if (strpos($filename, '.gz')) {
				@rename($src, $src . '.gz');
				@system('gunzip ' . escapeshellarg($src . '.gz'));
			}

			if ($filesize) {
				$data = @file_get_contents($src);
			}
			unlink($src);
		}

		// import channel from another server
		if (!$src) {
			$old_address = ((x($_REQUEST, 'old_address')) ? $_REQUEST['old_address'] : '');
			if (!$old_address) {
				logger('Nothing to import.');
				notice(t('Nothing to import.') . EOL);
				return;
			}
			else if (strpos($old_address, '@')) {
				// if you copy the identity address from your profile page, make it work for convenience - WARNING: this is a utf-8 variant and NOT an ASCII ampersand. Please do not edit.
				$old_address = str_replace('@', '@', $old_address);
			}

			$email    = ((x($_REQUEST, 'email')) ? $_REQUEST['email'] : '');
			$password = ((x($_REQUEST, 'password')) ? $_REQUEST['password'] : '');

			$channelname = substr($old_address, 0, strpos($old_address, '@'));
			$servername  = substr($old_address, strpos($old_address, '@') + 1);

			$api_path = probe_api_path($servername);
			if (!$api_path) {
				notice(t('Unable to download data from old server') . EOL);
				return;
			}

			$api_path .= 'channel/export/basic?f=&channel=' . $channelname;

			$binary    = false;
			$redirects = 0;
			$opts      = ['http_auth' => $email . ':' . $password];
			$ret       = z_fetch_url($api_path, $binary, $redirects, $opts);
			if ($ret['success']) {
				$data = $ret['body'];
			}
			else {
				notice(t('Unable to download data from old server') . EOL);
				return;
			}
		}

		if (!$data) {
			logger('Empty import file.');
			notice(t('Imported file is empty.') . EOL);
			return;
		}

		$data = json_decode($data, true);

		//logger('import: data: ' . print_r($data,true));
		//print_r($data);

		if (!array_key_exists('compatibility', $data)) {
			call_hooks('import_foreign_channel_data', $data);
			if ($data['handled'])
				return;
		}

// This is only an info message but it is alarming to folks who then report failure with this as the cause, when in fact we ignore this completely.
//		if(array_key_exists('compatibility',$data) && array_key_exists('database',$data['compatibility'])) {
//			$v1 = substr($data['compatibility']['database'],-4);
//			$v2 = substr(DB_UPDATE_VERSION,-4);
//			if($v2 > $v1) {
//				$t = sprintf( t('Warning: Database versions differ by %1$d updates.'), $v2 - $v1 );
//				notice($t);
//			}
//
//		}


		// prevent incompatible osada or zap data from horking your database

		if (array_path_exists('compatibility/codebase', $data)) {
			notice('Data export format is not compatible with this software');
			return;
		}

		if (version_compare($data['compatibility']['version'], '4.7.3', '<=')) {
			// zot6 transition: cloning is not compatible with older versions
			notice('Data export format is not compatible with this software (not a zot6 channel)');
			return;
		}

		if ($moving)
			$seize = 1;

		// import channel

		$relocate = ((array_key_exists('relocate', $data)) ? $data['relocate'] : null);

		if (array_key_exists('channel', $data)) {

			$max_identities = account_service_class_fetch($account_id, 'total_identities');

			if ($max_identities !== false) {
				$r = q("select channel_id from channel where channel_account_id = %d and channel_removed = 0",
					intval($account_id)
				);
				if ($r && count($r) > $max_identities) {
					notice(sprintf(t('Your service plan only allows %d channels.'), $max_identities) . EOL);
					return;
				}
			}

			if ($newname) {
				$x = false;

				if (Config::Get('system', 'unicode_usernames')) {
					$x = punify(mb_strtolower($newname));
				}

				if ((!$x) || strlen($x) > 64) {
					$x = strtolower(URLify::transliterate($newname));
				}
				$newname = $x;
			}

			$channel = import_channel($data['channel'], $account_id, $seize, $newname);
		}
		else {
			$moving  = false;
			$channel = App::get_channel();
		}

		if (!$channel) {
			logger('Channel not found. ', print_r($channel, true));
			notice(t('No channel. Import failed.') . EOL);
			return;
		}

		if ($channel['channel_removed']) {
			logger('Channel exists but has been marked removed on this hub. ', print_r($channel,true));
			notice( t('Channel exists but has been marked removed on this hub. Import failed.') . EOL);
			return;
		}

		if (is_array($data['config'])) {
			import_config($channel, $data['config']);
		}

		logger('import step 2');

		if (array_key_exists('channel', $data)) {
			if ($data['photo']) {
				require_once('include/photo/photo_driver.php');
				import_channel_photo(base64url_decode($data['photo']['data']), $data['photo']['type'], $account_id, $channel['channel_id']);
			}

			if (is_array($data['profile']))
				import_profiles($channel, $data['profile']);
		}

		logger('import step 3');

		// create new hubloc for the new channel at this site

		if (array_key_exists('channel', $data)) {

			// create a new zot6 hubloc

			$r = hubloc_store_lowlevel(
				[
					'hubloc_guid'     => $channel['channel_guid'],
					'hubloc_guid_sig' => $channel['channel_guid_sig'],
					'hubloc_hash'     => $channel['channel_hash'],
					'hubloc_addr'     => channel_reddress($channel),
					'hubloc_network'  => 'zot6',
					'hubloc_primary'  => (($seize) ? 1 : 0),
					'hubloc_url'      => z_root(),
					'hubloc_url_sig'  => Libzot::sign(z_root(), $channel['channel_prvkey']),
					'hubloc_host'     => App::get_hostname(),
					'hubloc_callback' => z_root() . '/zot',
					'hubloc_sitekey'  => Config::Get('system', 'pubkey'),
					'hubloc_updated'  => datetime_convert(),
					'hubloc_id_url'   => channel_url($channel),
					'hubloc_site_id'  => Libzot::make_xchan_hash(z_root(), Config::Get('system', 'pubkey'))
				]
			);

			// reset the original primary hubloc if it is being seized
			if ($seize) {
				$r = q("update hubloc set hubloc_primary = 0 where hubloc_primary = 1 and hubloc_hash = '%s' and hubloc_url != '%s' ",
					dbesc($channel['channel_hash']),
					dbesc(z_root())
				);
			}

		}

		logger('import step 4');

		// import xchans and contact photos

		if (array_key_exists('channel', $data) && $seize) {

			// replace any existing xchan we may have on this site if we're seizing control

			$r = q("delete from xchan where xchan_hash = '%s'",
				dbesc($channel['channel_hash'])
			);

			$r = xchan_store_lowlevel(
				[
					'xchan_hash'       => $channel['channel_hash'],
					'xchan_guid'       => $channel['channel_guid'],
					'xchan_guid_sig'   => $channel['channel_guid_sig'],
					'xchan_pubkey'     => $channel['channel_pubkey'],
					'xchan_photo_l'    => z_root() . "/photo/profile/l/" . $channel['channel_id'],
					'xchan_photo_m'    => z_root() . "/photo/profile/m/" . $channel['channel_id'],
					'xchan_photo_s'    => z_root() . "/photo/profile/s/" . $channel['channel_id'],
					'xchan_addr'       => channel_reddress($channel),
					'xchan_url'        => z_root() . '/channel/' . $channel['channel_address'],
					'xchan_connurl'    => z_root() . '/poco/' . $channel['channel_address'],
					'xchan_follow'     => z_root() . '/follow?f=&url=%s',
					'xchan_name'       => $channel['channel_name'],
					'xchan_network'    => 'zot6',
					'xchan_photo_date' => datetime_convert(),
					'xchan_name_date'  => datetime_convert()
				]
			);

		}

		logger('import step 5');

		// import xchans
		$xchans = $data['xchan'];
		if ($xchans) {
			foreach ($xchans as $xchan) {

				if ($xchan['xchan_network'] === 'zot6') {
					$zhash = Libzot::make_xchan_hash($xchan['xchan_guid'], $xchan['xchan_pubkey']);
					if ($zhash !== $xchan['xchan_hash']) {
						logger('forged xchan: ' . print_r($xchan, true));
						continue;
					}
				}

				if (!array_key_exists('xchan_hidden', $xchan)) {
					$xchan['xchan_hidden']       = (($xchan['xchan_flags'] & 0x0001) ? 1 : 0);
					$xchan['xchan_orphan']       = (($xchan['xchan_flags'] & 0x0002) ? 1 : 0);
					$xchan['xchan_censored']     = (($xchan['xchan_flags'] & 0x0004) ? 1 : 0);
					$xchan['xchan_selfcensored'] = (($xchan['xchan_flags'] & 0x0008) ? 1 : 0);
					$xchan['xchan_system']       = (($xchan['xchan_flags'] & 0x0010) ? 1 : 0);
					$xchan['xchan_pubforum']     = (($xchan['xchan_flags'] & 0x0020) ? 1 : 0);
					$xchan['xchan_deleted']      = (($xchan['xchan_flags'] & 0x1000) ? 1 : 0);
				}

				$r = q("select xchan_hash from xchan where xchan_hash = '%s' limit 1",
					dbesc($xchan['xchan_hash'])
				);
				if ($r)
					continue;

				create_table_from_array('xchan', $xchan);

				require_once('include/photo/photo_driver.php');

				if ($xchan['xchan_hash'] === $channel['channel_hash']) {
					$r = q("update xchan set xchan_photo_l = '%s', xchan_photo_m = '%s', xchan_photo_s = '%s' where xchan_hash = '%s'",
						dbesc(z_root() . '/photo/profile/l/' . $channel['channel_id']),
						dbesc(z_root() . '/photo/profile/m/' . $channel['channel_id']),
						dbesc(z_root() . '/photo/profile/s/' . $channel['channel_id']),
						dbesc($xchan['xchan_hash'])
					);
				}
				else {
					$photos = import_xchan_photo($xchan['xchan_photo_l'], $xchan['xchan_hash']);
					if ($photos[4])
						$photodate = NULL_DATE;
					else
						$photodate = $xchan['xchan_photo_date'];

					q("update xchan set xchan_photo_l = '%s', xchan_photo_m = '%s', xchan_photo_s = '%s', xchan_photo_mimetype = '%s', xchan_photo_date = '%s' where xchan_hash = '%s'",
						dbesc($photos[0]),
						dbesc($photos[1]),
						dbesc($photos[2]),
						dbesc($photos[3]),
						dbesc($photodate),
						dbesc($xchan['xchan_hash'])
					);
				}
			}

			logger('import step 6');
		}

		logger('import step 7');

		// this must happen after xchans got imported!
		if (is_array($data['hubloc'])) {
			import_hublocs($channel, $data['hubloc'], $seize, $moving);
		}

		$friends = 0;
		$feeds   = 0;

		// import contacts
		$abooks = $data['abook'];
		if ($abooks) {
			foreach ($abooks as $abook) {

				$abook_copy = $abook;

				$abconfig = null;
				if (array_key_exists('abconfig', $abook) && is_array($abook['abconfig']) && count($abook['abconfig']))
					$abconfig = $abook['abconfig'];

				unset($abook['abook_id']);
				unset($abook['abook_rating']);
				unset($abook['abook_rating_text']);
				unset($abook['abconfig']);
				unset($abook['abook_their_perms']);
				unset($abook['abook_my_perms']);
				unset($abook['abook_not_here']);

				$abook['abook_account'] = $account_id;
				$abook['abook_channel'] = $channel['channel_id'];
				if (!array_key_exists('abook_blocked', $abook)) {
					$abook['abook_blocked']     = (($abook['abook_flags'] & 0x0001) ? 1 : 0);
					$abook['abook_ignored']     = (($abook['abook_flags'] & 0x0002) ? 1 : 0);
					$abook['abook_hidden']      = (($abook['abook_flags'] & 0x0004) ? 1 : 0);
					$abook['abook_archived']    = (($abook['abook_flags'] & 0x0008) ? 1 : 0);
					$abook['abook_pending']     = (($abook['abook_flags'] & 0x0010) ? 1 : 0);
					$abook['abook_unconnected'] = (($abook['abook_flags'] & 0x0020) ? 1 : 0);
					$abook['abook_self']        = (($abook['abook_flags'] & 0x0080) ? 1 : 0);
					$abook['abook_feed']        = (($abook['abook_flags'] & 0x0100) ? 1 : 0);
				}

				if (array_key_exists('abook_instance', $abook) && $abook['abook_instance'] && strpos($abook['abook_instance'], z_root()) === false) {
					$abook['abook_not_here'] = 1;
				}

				if ($abook['abook_self']) {
					$role = get_pconfig($channel['channel_id'], 'system', 'permissions_role');
					if (($role === 'forum') || ($abook['abook_my_perms'] & PERMS_W_TAGWALL)) {
						q("update xchan set xchan_pubforum = 1 where xchan_hash = '%s' ",
							dbesc($abook['abook_xchan'])
						);
					}
				}
				else {
					if ($max_friends !== false && $friends > $max_friends)
						continue;
					if ($max_feeds !== false && intval($abook['abook_feed']) && ($feeds > $max_feeds))
						continue;
				}

				$r = q("select abook_id from abook where abook_xchan = '%s' and abook_channel = %d limit 1",
					dbesc($abook['abook_xchan']),
					intval($channel['channel_id'])
				);
				if ($r) {
					foreach ($abook as $k => $v) {
						q("UPDATE abook SET " . TQUOT . "%s" . TQUOT . " = '%s' WHERE abook_xchan = '%s' AND abook_channel = %d",
							dbesc($k),
							dbesc($v),
							dbesc($abook['abook_xchan']),
							intval($channel['channel_id'])
						);
					}
				}
				else {
					abook_store_lowlevel($abook);

					$friends++;
					if (intval($abook['abook_feed']))
						$feeds++;
				}

				translate_abook_perms_inbound($channel, $abook_copy);

				if ($abconfig) {
					/// @FIXME does not handle sync of del_abconfig
					foreach ($abconfig as $abc) {
						set_abconfig($channel['channel_id'], $abc['xchan'], $abc['cat'], $abc['k'], $abc['v']);
					}
				}
			}

			logger('import step 8');
		}


		// import groups
		$groups = $data['group'];
		if ($groups) {
			$saved = [];
			foreach ($groups as $group) {
				$saved[$group['hash']] = ['old' => $group['id']];
				if (array_key_exists('name', $group)) {
					$group['gname'] = $group['name'];
					unset($group['name']);
				}
				unset($group['id']);
				$group['uid'] = $channel['channel_id'];

				create_table_from_array('pgrp', $group);
			}
			$r = q("select * from pgrp where uid = %d",
				intval($channel['channel_id'])
			);
			if ($r) {
				foreach ($r as $rr) {
					$saved[$rr['hash']]['new'] = $rr['id'];
				}
			}
		}

		// import group members
		$group_members = $data['group_member'];
		if ($group_members) {
			foreach ($group_members as $group_member) {
				unset($group_member['id']);
				$group_member['uid'] = $channel['channel_id'];
				foreach ($saved as $x) {
					if ($x['old'] == $group_member['gid'])
						$group_member['gid'] = $x['new'];
				}
				create_table_from_array('pgrp_member', $group_member);
			}
		}

		logger('import step 9');


		if (is_array($data['obj']))
			import_objs($channel, $data['obj']);

		if (is_array($data['likes']))
			import_likes($channel, $data['likes']);

		if (is_array($data['app']))
			import_apps($channel, $data['app']);

		if (is_array($data['sysapp']))
			import_sysapps($channel, $data['sysapp']);

		if (is_array($data['chatroom']))
			import_chatrooms($channel, $data['chatroom']);

		if (is_array($data['event']))
			import_events($channel, $data['event']);

		if (is_array($data['event_item']))
			import_items($channel, $data['event_item'], false, $relocate);

		if (is_array($data['menu']))
			import_menus($channel, $data['menu']);

		if (is_array($data['wiki']))
			import_items($channel, $data['wiki'], false, $relocate);

		if (is_array($data['webpages']))
			import_items($channel, $data['webpages'], false, $relocate);

		$addon = ['channel' => $channel, 'data' => $data];
		call_hooks('import_channel', $addon);

		if ($import_posts && array_key_exists('item', $data) && $data['item']) {
			import_items($channel, $data['item'], false, $relocate);
		}

		// Immediately notify old server about the new clone
		Master::Summon(['Notifier', 'refresh_all', $channel['channel_id']]);

		// This will indirectly perform a refresh_all *and* update the directory
		Master::Summon(['Directory', $channel['channel_id']]);

		if ($api_path) {
			$parsed = parse_url($api_path);
			unset($parsed['path']);
			unset($parsed['query']);

			// store the import host so we can manually kick off item/file sync later in case anything did not work out
			set_pconfig($channel['channel_id'], 'import', 'host', $parsed['host']);

			$hz_server = unparse_url($parsed);
		}

		$cf_api_compat = false;

		if ($api_path && $hz_server && $import_posts) {  // we are importing from a server and not a file
			if (version_compare($data['compatibility']['version'], '6.3.4', '>=')) {
				$cf_api_compat = true;

				$since = datetime_convert(date_default_timezone_get(), date_default_timezone_get(), '0001-01-01 00:00');
				$until = datetime_convert(date_default_timezone_get(), date_default_timezone_get(), 'now + 1 day');

				//$poll_interval = Config::Get('system', 'poll_interval', 3);
				$page = 0;

				Master::Summon(['Content_importer', sprintf('%d', $page), $since, $until, $channel['channel_address'], urlencode($hz_server)]);
				Master::Summon(['File_importer', sprintf('%d', $page), $channel['channel_address'], urlencode($hz_server)]);
			}
		}

		change_channel($channel['channel_id']);

		if ($api_path && $import_posts && $cf_api_compat) {
			goaway(z_root() . '/import_progress');
		}

		if ($import_posts && !$cf_api_compat) {
			notice(t('Automatic content and files import was not possible due to API version incompatiblity. Please import content and files manually!') . EOL);
		}

		goaway(z_root());

	}

	/**
	 * @brief Handle POST action on channel import page.
	 */
	function post() {
		$account_id = get_account_id();
		if (!$account_id)
			return;

		check_form_security_token_redirectOnErr('/import', 'channel_import');

		$this->import_account($account_id);
	}

	/**
	 * @brief Generate channel import page.
	 *
	 * @return string with parsed HTML.
	 */
	function get() {

		if (!get_account_id()) {
			notice(t('You must be logged in to use this feature.') . EOL);
			return '';
		}

		nav_set_selected('Channel Import');

		$o = replace_macros(get_markup_template('channel_import.tpl'), [
			'$title'          => t('Channel Import'),
			'$desc'           => t('Use this form to import an existing channel from a different server/hub. You may retrieve the channel identity from the old server/hub via the network or provide an export file.'),
			'$label_filename' => t('File to Upload'),
			'$choice'         => t('Or provide the old server/hub details'),

			'$old_address'  => ['old_address', t('Your old identity address (xyz@example.com)'), '', ''],
			'$email'        => ['email', t('Your old login email address'), '', ''],
			'$password'     => ['password', t('Your old login password'), '', ''],
			'$import_posts' => ['import_posts', t('Import your items and files (limited by available memory)'), false, '', [t('No'), t('Yes')]],

			'$common' => t('For either option, please choose whether to make this hub your new primary address, or whether your old location should continue this role. You will be able to post from either location, but only one can be marked as the primary location for files, photos, and media.'),

			'$make_primary' => ['make_primary', t('Make this hub my primary location'), false, '', [t('No'), t('Yes')]],
			'$moving'       => ['moving', t('Move this channel (disable all previous locations)'), false, '', [t('No'), t('Yes')]],
			'$newname'      => ['newname', t('Use this channel nickname instead of the one provided'), '', t('Leave blank to keep your existing channel nickname. You will be randomly assigned a similar nickname if either name is already allocated on this site.')],

			'$pleasewait' => t('This process may take several minutes to complete. Please submit the form only once and leave this page open until finished.'),

			'$form_security_token' => get_form_security_token('channel_import'),
			'$submit'              => t('Submit')
		]);

		return $o;
	}

}