<html>
<title>WAP BASIC (PHP-WAP-BASIC MOD)</title>
<head>
<link href="styles.css" rel="stylesheet" type="text/css\">
</head>
<body>
<big>WAPBASIC V1.0 © 2006 [email protected]</big><br/>
<b>Короткое вступление.</b>
<p align="justify">
Данные модуль, не претендует на "звание" языка
программирования и тем более на какую-либо профессиональную<br/>
среду разработки WEB и WAP приложений. Это просто маленькая
помощь тем, кто только начинает изучать PHP и WML.<br/>
Тут не будет описания команд, как таковых, а только примеры
использования WAPBASIC.<br/>
<b>С чего начать?</b><br/>
Для начала нужно создать PHP файл, например в блокноте, с
любым произвольным именем, создадим: <strong>index.php</strong><br/>
Напишем в нём следующий текст:<br/>
<table width="100%" bgcolor="#eeeeff"><tr><td>
<i>
<?<br/>
include ("system.php");<br/>
WB_noerrors();<br/>
WB_autoheader ("index","Первый файл","0","");<br/>
_startalign ();<br/>
WB_print("Мой первый файл");<br/>
WB_br(1);<br/>
WB_showline();<br/>
_endalign ();<br/>
WB_autoclose ();<br/>
DIE("");<br/>
?>
</i>
</td></tr></table>
<br/>
<strong>Давайте теперь рассмотрим более детально наш код.</strong><br/>
<strong>include ("system.php");</strong><br/>
Данной командой мы подключаем библиотеку WAPBASIC (system.php).<hr/>
<strong>WB_noerrors();</strong><br/>
А эта команда отключает показ критических ошибок в PHP коде.<hr/>
<strong>WB_autoheader ("index","Первый файл","0","");</strong><br/>
На этой команде стоит остановиться подробней!<br/>
Во-первых, данная команда автоматически создаёт заголовок
для WAP или WAP2.0 (XHTML) документа.<br/>
index=card id, Первый файл=title<br/>
0=Время в милисекундах, через которое страница обновится.<br/>
И последние кавычки, по какому адресу будет обновление.<br/>
<strong>Например:</strong><br/>
WB_autoheader ("index","Первый файл","600","index.php");<br/>
Обновит страницу index.php через 10 секунд.<br/>
<u>Для WAP2.0 версии желательно присутствие файла styles.css</u>
<hr/>
<strong>_startalign ();</strong><br/>
После этой команды идёт основная программа. Данная команда,
форматирует вывод текста на экран. И имеет три вида:<br/>
_startalign (); - Вывод текста по левому краю.<br/>
_startaligncenter (); - Вывод текста по центру.<br/>
_startalignright (); - Вывод текста по правому краю.
<hr/>
<strong>WB_print("Мой первый файл");</strong><br/>
Аналог бейсиковской команды <b>PRINT</b>. Выводит текст
в кодировке UTF8. Позволяет включать тэги в текст и переменные.<br/>
<strong>Например:</strong><br/>
$name="ВАСЯ ПЛЮШКИН";<br/>
WB_print("<b>Привет, $name</b>");
<hr/>
<strong>WB_br(1);</strong><br/>
Команда переноса строки! <u>ОЧЕНЬ НУЖНАЯ КОМАНДА</u><br/>
Параметр в скобках показывает на сколько линий осуществить
перенос строки. Пишется после любой команды вывода WAPBASIC.<br/>
Аналог тега: <b><br/></b>
<hr/>
<strong>WB_showline();</strong><br/>
Команда вывода линии на экран. Адаптирована для WAP и WAP2.0 (XHTML).
<hr/>
<strong>_endalign ();</strong><br/>
Команда окончания форматирования текста. Закрывает любой из:<br/>
_startalign ();<br/>
_startaligncenter ();<br/>
_startalignright ();<hr/>
<strong>WB_autoclose ();</strong><br/>
Показывает, что документ окончен.<hr/>
<strong>DIE("");</strong><br/>
Показывает, что дальше програмного кода нет. <u>Обязательна</u>
после: WB_autoclose ();
<hr/>
Фактически, можно использовать такую конструкцию (шаблон):<br/>
<table width="100%" bgcolor="#eeeeff"><tr><td>
<i>
<?<br/>
include ("system.php");<br/>
WB_noerrors();<br/>
WB_autoheader ("index","Первый файл","0","");<br/>
_startalign ();<br/>
...КОД PHP, WML, ИЛИ HTML<br/>
_endalign ();<br/>
WB_autoclose ();<br/>
DIE("");<br/>
?>
</i>
</td></tr></table>
<br/>
<strong>Давайте, посмотрим, какие типы заголовков бывают ещё.</strong><br/>
<em>WB_wapheader ("id","title","time","url");</em><br/>
Заголовок для WAP документов. Т.е если сайт ориентирован <u>ТОЛЬКО</u> на WAP.<br/>
Закрывается командой: <em>WB_wapclose ();</em><br/>
<em>WB_xhtmlheader ("id","title","time","url");</em><br/>
Заголовок для XHTML (WAP2.0, WEB) документов. Т.е если сайт ориентирован <u>ТОЛЬКО</u> на WAP2.0 или WEB.<br/>
Закрывается командой: <em>WB_xhtmlclose ();</em><br/>
В WAPBASIC, есть встроенная переменная, по которой можно
определить вошли-ли вы с WAP устройства или с компьютера.<br/>
Вот эта переменная: <strong>$iswap</strong><br/>
Вот код, который проверяет WAP вход или WAP2.0:<br/>
<table width="100%" bgcolor="#eeeeff"><tr><td>
<i>
if ($iswap=="false") {<br/>
WB_print ("ВЫ ТУТ С КОМПА!");<br/>
} else {<br/>
WB_print ("ВЫ ТУТ С ТЕЛЕФОНА!");<br/>
}<br/>
</i>
</td></tr></table><br/>
<strong>Перейдём к рассмотрению дополнительных функций.</strong><br/>
WAPBASIC имеет функции простого создание ссылок, картинок, полей ввода текста.<br/>
Начнём с ссылки. Если вам знакомы теги HTML, то вы знаете:<br/>
Чтобы создать ссылку, нужно написать:<br/>
<em>
<a href="http://путь_к_сайту">На сайт</a>
</em><br/>
Как это неудобно! Посмотрим как это делается в WAPBASIC:<br/>
<em>
WB_link("http://путь_к_сайту","На сайт");</em><br/>
Правда ведь проще? :)<br/>
Теперь вывод картинки:<br/>
<em>
WB_image ("http://путь_к_картинке","описание");
</em><br/>
Создаём поле ввода:<br/>
<em>
WB_input ("text","test","HELLO","20");
</em><br/>
Мы создали поле для ввода текста (<strong>text</strong>),
который будет сохранён в переменную (<strong>test</strong>),<br/>
Начальное значение переменной будет (<strong>HELLO</strong>),
а максимальный размер ввода 20 символов.<br/>
Пример:
<table width="100%" bgcolor="#eeeeff"><tr><td>
<i>
<?<br/>
include ("system.php");<br/>
WB_noerrors();<br/>
WB_autoheader ("index","Первый файл","0","");<br/>
_startalign ();<br/>
WB_print("Ваше имя (макс. 20):");<br/>
WB_br(1);<br/>
WB_input ("text","name","Alex5","20");<br/>
WB_br(1);<br/>
_endalign ();<br/>
WB_autoclose ();<br/>
DIE("");<br/>
?>
</i>
</td></tr></table>
Просто запустите и посмотрите результат!<br/>
Вместо параметра <strong>text</strong>, могут быть следующие
параметры:<br/>
password - ввод пароля<br/>
submit - кнопка отправки формы<br/>
И другие, стандартные параметры input.<br/>
Кстати, разговор о формах ещё не закончен :)<br/>
<u>Внимание! Не забываете ставить после команд вывода WB_br(1);.</u><br/>
Рассмотрим ещё две интересные функции WAPBASIC!<br/>
<strong>WB_rndword ("имя_файла");</strong><br/>
Функция выводит случайную фразу из файла: <strong>имя_файла</strong>.<br/>
Не стану долго описывать функцию, просто приведу пример.<br/>
Создайте файл: friends.txt и запишите следующий текст:<br/>
<table width="100%" bgcolor="#eeeeff"><tr><td>
<i>
ПЕТЯ<br/>
ВАСЯ<br/>
МАНЯ<br/>
ВАНЯ<br/>
СЕРЁЖКА<br/>
[email protected]<br/>
</i>
</td></tr></table>
Теперь, сохраните файл. Напишем такой код:<br/>
<table width="100%" bgcolor="#eeeeff"><tr><td>
<i>
<?<br/>
include ("system.php");<br/>
WB_noerrors();<br/>
WB_autoheader ("index","Первый файл","0","");<br/>
_startalign ();<br/>
$friend=WB_rndword ("friends.txt");<br/>
WB_print ("У вас есть хороший друг: $friend");<br/>
_endalign ();<br/>
WB_autoclose ();<br/>
DIE("");<br/>
?>
</i>
</td></tr></table>
Теперь запустите и посмотрите полученный код.<br/>
Ещё одна полезная функция, позволяет вывести файл на экран.
Выводит с тегами и.т.д в кодировке UTF8.<br/>
<strong>WB_showfile ("имя_файла");</strong><br/>
Выводит текст из файла на экран. Поддерживает теги HTML и WML.
<hr/>
<strong>Короткое отступление. Или <anchor> и <form>.</strong><br/>
Всем, конечно хороши две версии сайта. И WAP радует и WAP2.0 отличный, но
есть маленькая проблемка, а именно <b>ФОРМЫ</b>. Поэтому многие и
делают только одну версию сайта. Или WAP или WEB.<br/>
В WAPBASIC есть удобное решение вывода различных форм, для
различных версий сайта (<small>Требует знание WML и HTML</small>).<br/>
Итак, чтобы не нарушать дизайн и не использовать сложные XML (XSL) средства,
вы можете воспользоваться функцией:<br/>
<strong>WB_addform("имя_файла_формы");</strong><br/>
Как работает данная функция? А очень просто!<br/>
Для каждого из вариантов сайта можно создать свою форму.<br/>
Приведу пример использования функции:<br/>
<em>
WB_addform("login");</em><br/>
Данная команда, будет работать сразу с двумя формами, которые
вам придётся создать. Для версии WAP: <strong>login.wapf</strong>,
для версии WAP2.0 или WEB: <strong>login.webf</strong>.<br/>
Содержание форм:<br/>
<small>login.wapf</small>
<table width="100%" bgcolor="#eeeeff"><tr><td>
<i>
Введите ваше имя:<br/><br/>
<input type="text" name="nam" value=""/><br/><br/>
<anchor>Принять<br/>
<go href="name.php" method="get"><br/>
<postfield name="nam" value="$(name)"/><br/>
</go></anchor><br/><br/>
</i>
</td></tr></table>
<small>login.webf</small>
<table width="100%" bgcolor="#eeeeff"><tr><td>
<i>
<form action="name.php" method="get">
Введите ваше имя:<br/><br/>
<input type="text" name="nam" value=""/><br/><br/>
<input type="submit" value="Принять"/><br/><br/>
</form>
</i>
</td></tr></table>
Теперь создадим файл <strong>name.php</strong> и напишем код:<br/>
<table width="100%" bgcolor="#eeeeff"><tr><td>
<i>
<?<br/>
include ("system.php");<br/>
WB_noerrors();<br/>
$nam=$_GET["nam"];
WB_autoheader ("index","Первый файл","0","");<br/>
_startalign ();<br/>
WB_print ("Приняли имя: [$nam]");<br/>
WB_br(1);<br/>
WB_addform("login");<br/>
_endalign ();<br/>
WB_autoclose ();<br/>
DIE("");<br/>
?>
</i>
</td></tr></table>
Можете посмотреть на результат работы.<hr/>
<strong>ФУНКЦИИ, ОСТАВШИЕСЯ ЗА КАДРОМ.</strong><br/>
В WAPBASIC осталось ещё несколько функций, которые <u>ВОЗМОЖНО</u> вам пригодяться.<br/>
<br/>
<strong>WB_filecount ("имя_файла");</strong><br/>
Функция подсчитывает кол-во записей в файле. Пример:<br/>
<em>
$myfriends=WB_filecount ("friends.txt");<br/>
WB_print ("У меня есть $myfriends друзей!");<br/>
</em><br/>
<hr/>
<strong>_urlredirect ("http://путь");</strong><br/>
Функция переадресовывает посетителя на другой сайт.<br/>
Пример кода:<br/>
<table width="100%" bgcolor="#eeeeff"><tr><td>
<i>
<?<br/>
include ("system.php");<br/>
_urlredirect("http://in2wap.net");<br/>
DIE("");<br/>
?>
</i>
</td></tr></table>
Заметьте! Заголовки не описываются!!! Иначе будет ошибка!<hr/>
<strong>wchrformat ("текст"); и uchrformat ("текст");</strong><br/>
wchrformat ("текст"); - переводит текст в кодировку WINDOWS-1251.<br/>
uchrformat ("текст"); - переводит текст в кодировку UTF8.<br/>
Прелесть этих функций в том, что они работают с <u>любыми</u> кодировками.<hr/>
<strong>browser_type();</strong><br/>
Показывает ваш браузер или модель вашего телефона.<hr/>
<br/><br/>
Автор очень надеется, что WAPBASIC и данное руководство помогут
начать изучение PHP и сделать ваши WAP сайты более привлекательными.<br/>
Просьба ко всем пользователям: <u>НЕ ВНОСИТЬ ИЗМЕНЕНИЯ В ИСХОДНЫЙ КОД system.php</u>
</p>
С Уважением, © 2006 <a href="mailto:[email protected]">In2W@P</a><br/>
</body>
</html>