Скрипт импорта контактов для телефонов Nokia 108, 220, 225

Простой и универсальный способ импорта списка контактов в телефоны Nokia на платформе S30+ используя MS Excel (OpenOffice Spreadsheet) ипростой  скрипт на PHP.

Случилось так что телефоны на базе платформы S30+ не поддерживают Nokia PC Suite и другие менеджеры, благодаря которым можно полностью управлять содержимым своего телефона от Nokia.

Включаем смекалку, исследуем и добиваемся поставленной задачи!

Содержание:

1. Предисловие
2. Принцип импорта контактов
3. Формат vCard
4. Подготовка списка контактов
5. PHP скрипт генерации файла vCard
6. Заключение

Предисловие

Прогресс не стоит на месте и повсеместно используют смартфоны на Android, в которых подобных проблем нет, поскольку программного обеспечения для таких смартфонов есть масса и на любой вкус.

Но в то же время не всем нужен мощный смартфон, особенно если предполагается использовать устройство преимущественно для звонков. В сегменте простых телефонов-звонилок бренд Nokia уже давно зарекомендовал себя как один из лидеров. Данные телефоны  просты в использовании, надежно собраны и имеют некоторые простые но приятные плюшки типа: фонарик, FM-радио и другие.

После покупки компании гигантом Майкрософт, программное обеспечение телефонов Nokia очень изменилось, и в некоторых случаях принесло некоторые неудобства и недовольство со стороны пользователей. Привыкать к чему-то новому не всегда может оказаться простым процессом, к тому же не все новое бывает лучше сделано чем старое.

Данная статья поможет вам импортировать ваш список контактов из таблички MS Excel или OpenOffice Spreadsheet в ваш телефон буквально в несколько шагов. О том как перевести ваши контакты из Outlook Express, Gmail и других программ и сервисов в таблицу MS Excel я рассказывать не буду, думаю сами разберетесь.

Метод подходит для импорта контактов в телефоны Nokia 108, 220, 225. Также подобный подход можно применить и для других моделей телефонов.

Принцип импорта контактов

В телефонах Nokia на платформе S30+ можно сделать резервную копию контактов и настроек.  Для этого есть отдельный пункт в меню Настройки(Settings), который зовется "Резервное копирование"(Backup) или же как-то по другому в зависимости от марки телефона и используемого языка меню. Если такого пункта нет то скорее всего похожая опция присутствует в списке ваших контактов, в настройках или опциях(Settings) для списка контактов.

Чтобы иметь возможность делать резервную копию в телефон нужно установить карту памяти MicroSD, на ней будет создана папка Backup, а в ней после резервного копирования появится файлик под именем: backup.dat .

Если открыть данный файл то в нем обнаружим записи наподобие тех что отображены ниже:

BEGIN:VCARD
VERSION:2.1
N;ENCODING=QUOTED-PRINTABLE;CHARSET=UTF-8:;Morpheus;;;
TEL;VOICE;CELL:+998777711110
END:VCARD

BEGIN:VCARD
VERSION:2.1
N;ENCODING=QUOTED-PRINTABLE;CHARSET=UTF-8:;Trinity;;;
TEL;VOICE;CELL:+998777711100
END:VCARD

BEGIN:VCARD
VERSION:2.1
N;ENCODING=QUOTED-PRINTABLE;CHARSET=UTF-8:;Mr. Smith;;;
TEL;VOICE;CELL:+991000010000
END:VCARD

BEGIN:VCARD
VERSION:2.1
N;ENCODING=QUOTED-PRINTABLE;CHARSET=UTF-8:;=D0=9C=D0=BE=D0=B4=D0=B5=D0=BC DSM2K;;;
TEL;VOICE;CELL:+991010101010
END:VCARD

Как видим, здесь четыре записи с похожим шаблоном, количество таких записей равно количеству контактов в нашем телефоне.

Подобный файл можно составить самому, загрузить его на место файла backup.dat , что на карточке MicroSD, и потом в телефоне сделать восстановление контактов из резервной копии.

Остается разобраться что это за формат и как нам сделать генерацию файла со всеми контактами в таком формате.

Формат vCard

VCard - это формат разработанный для обмена электронными визитными карточками в текстовом формате. Данный формат подробно описан в Википедии, нам же нужно знать всего малость из его структуры.

Рассмотрим то что нагенерировал нам телефон, построчно:

BEGIN:VCARD - начало карточки
VERSION:2.1 - указывается используемая версия спецификации vCard.

N;ENCODING=QUOTED-PRINTABLE;CHARSET=UTF-8:;Trinity;;; - содержит Имя, N(Name). Сначала указаны особенности использования кодировки (метод quoted-printable), кодировку символов(UTF-8, юникод) и в конце само имя - Trinity. Обратите внимание на разделители ";", каждое поле ключ-значение использует разделитель, в конце должно присутствовать такое же количество закрывающих разделителей.
TEL;VOICE;CELL:+998777711100 - указан телефонный номер для всех типов дозвона.
END:VCARD - конец карточки.

Для составления файла с контактами нужно генерировать для каждого контакта вот такую запись(карточку), изменив имя и телефон (Trinity, +998777711100).

Но есть особенность для использования кириллических символов. Как вы заметили в примере выше присутствует строка:

N;ENCODING=QUOTED-PRINTABLE;CHARSET=UTF-8:;=D0=9C=D0=BE=D0=B4=D0=B5=D0=BC DSM2K;;;

Здесь вместо имени набор символов: =D0=9C=D0=BE=D0=B4=D0=B5=D0=BC DSM2K .

Это закодированная запись "Модем DSM2K" с использованием метода quoted-printable в кодировке UTF-8. Кириллические символы были закодированы, а символы латиници остались как есть.

Подготовка списка контактов

Первым делом нужно собрать все контакты и сохранить их в удобном формате. Для работы будем использовать OpenOffice Spreadsheet (аналог MS Excel для работы с таблицами). Расскажу подробно и с рисунками, как для новичков.

Скачать пакет OpenOffice можно на официальном сайте, а также можно использовать портабельную версию без установки - качаем с сайта PortableApps OpenOffice Portable (~100Mb). Также можно использовать свободный пакет LibreOffice.

Запускаем OpenOffice, из меню приложений выбираем Spreadsheet (Таблица).

В первой колонке будем писать имя контакта, а во второй полный номер телефона, вот пример заполнения:

Готово? - Отлично! Сохраняем себе этот список в надежное место на компьютере, возможно еще когда-то пригодится, лишняя резервная копия не помешает.

Для удобства работы с данными нужно переконвертировать список в текстовый формат с разделителями - CSV(COmma Separated Values). Для этого идем в Файл(File) - Сохранить как(Save As). В списке где Тип файла(File type) выбираем Text CSV(.csv) и сохраняем.

ОпенОффис выдаст запрос о текущем формате документа - жмем Использовать текущий формат(Keep Current Format).

В диалоговом меню Экспорт текстовых файлов (Export of text files), которое появится, выбираем:

• кодировку (Character set) -  Cyrillic (Windows-1251);
• разделитель полей (Field delimiter) - символ ";" (точка с запятой);
• Разделитель текста (Text delimiter) - оставляем пустым.

Сохраняем файл под именем phones.csv, вот в каком формате он получится:

Name;Phone
Morpheus;+998777711110
Trinity ;+998777711100
Mr. Smith ;+991000010000
Модем DSM2K;+991010101010

Теперь осталось написать скрипт,  который из подобного формата будет генерировать файл резервной копии с записями в формате vCard.

PHP скрипт генерации файла vCard

Для запуска скрипта на языке PHP можно использовать локальный веб-сервер (Denwer, OpenServer) или же сервер на любом хостинге где установлен интерпретатор PHP. А можно скачать только сам PHP под Windows вот тут.

Вот исходный код скрипта:

/*------------------------------------
    CSV to vCard Contacts Converter
    for Nokia 108, 220, 225
    https://ph0en1x.net
--------------------------------------*/

// specify path to CSV phones book,
// in CP1251 encoding, splitter - ";"
$file = 'phones.csv';

// Generating simple vCard record for 
// Nokia 108, 220, 225 phones based on S30+ platform
function Nokia_vCard_Gen($name = '', $phone = '') {
	if(strlen($name)>16) {
		echo "WARNING: [".$name."] (".strlen($name).")".
			 " will be truncated to 16 symbols.\r\n";
		$name = substr($name, 0, 16);
	}
	$name = iconv("windows-1251", "utf-8", $name);
	$vCard = "BEGIN:VCARD\r\nVERSION:2.1\r\n";
	$vCard .= "N;ENCODING=QUOTED-PRINTABLE;CHARSET=UTF-8:;".
			 quoted_printable_encode($name).";;;\r\n";
	$vCard .= "TEL;VOICE;CELL:".$phone."\r\n";
	$vCard .= "END:VCARD\r\n";
	return $vCard;
}

$csv_file = file_get_contents($file);
$vCard = '';
$contacts_count = 0;
$csv_ex = explode("\r\n", $csv_file);
foreach($csv_ex as $line) {
	$line_ex = explode(";", $line);
	if(isset($line_ex[0]) && $line_ex[0]=='Phone') // Skip CSV header
		continue;
	if(isset($line_ex[0]) && $line_ex[0]!='' && isset($line_ex[1]) && $line_ex[1]!='') { 
		$vCard . = Nokia_vCard_Gen( trim($line_ex[0]), trim($line_ex[1]) );
		$contacts_count++;
	}
}

file_put_contents('backup.dat', $vCard);
echo 'Done. Contacts in backup: ' . $contacts_count . "
";
echo '<a' . ' href="backup.dat" download>Download backup.dat</' . 'a>';

Вот что делает скрипт. Считываем файл CSV и разбиваем его содержимое на строчки. Каждая строчка - это уже готовые данные для карточки, нужно только разбить ее используя разделитель ";". На основе полученных имени и номера телефона, для каждой строки в файле CSV генерируем карточку, используя функцию Nokia_vCard_Gen. Функция Nokia_vCard_Gen генерирует карточку на основе указанного имени и номера телефона, корректно кодирует кириллические символы. Все сгенерированные функцией карточки сохраняем в один файл.

Как использовать скрипт:

1. В папку со скриптом ложим наш файл phones.csv со списком контактов;
2. Запускаем скрипт на выполнение;
3. Скачиваем сгенерированный скриптом файл backup.dat (появится в папке со скриптом);
4. Загружаем backup.dat на MicroSD карточку в телефоне, в папку Backup;
5. Запускаем импорт контактов в телефоне.

Заключение

Весь комплект файлов с примерами всех документов можно скачать здесь: nokia-contacts-vcard-gen-php.zip (10Кб).

Используя знания из данной статьи можно написать похожие скрипты для импорта контактов в другие модели телефонов, которые используют для резервного копирования-восстановления формат vCard.