WAP BASIC (PHP-WAP-BASIC MOD)

WAPBASIC V1.0 © 2006 In2W@P.NET
Короткое вступление.

Данные модуль, не претендует на "звание" языка программирования и тем более на какую-либо профессиональную
среду разработки WEB и WAP приложений. Это просто маленькая помощь тем, кто только начинает изучать PHP и WML.
Тут не будет описания команд, как таковых, а только примеры использования WAPBASIC.
С чего начать?
Для начала нужно создать PHP файл, например в блокноте, с любым произвольным именем, создадим: index.php
Напишем в нём следующий текст:

<?
include ("system.php");
WB_noerrors();
WB_autoheader ("index","Первый файл","0","");
_startalign ();
WB_print("Мой первый файл");
WB_br(1);
WB_showline();
_endalign ();
WB_autoclose ();
DIE("");
?>

Давайте теперь рассмотрим более детально наш код.
include ("system.php");
Данной командой мы подключаем библиотеку WAPBASIC (system.php).

WB_noerrors();
А эта команда отключает показ критических ошибок в PHP коде.

WB_autoheader ("index","Первый файл","0","");
На этой команде стоит остановиться подробней!
Во-первых, данная команда автоматически создаёт заголовок для WAP или WAP2.0 (XHTML) документа.
index=card id, Первый файл=title
0=Время в милисекундах, через которое страница обновится.
И последние кавычки, по какому адресу будет обновление.
Например:
WB_autoheader ("index","Первый файл","600","index.php");
Обновит страницу index.php через 10 секунд.
Для WAP2.0 версии желательно присутствие файла styles.css

_startalign ();
После этой команды идёт основная программа. Данная команда, форматирует вывод текста на экран. И имеет три вида:
_startalign (); - Вывод текста по левому краю.
_startaligncenter (); - Вывод текста по центру.
_startalignright (); - Вывод текста по правому краю.

WB_print("Мой первый файл");
Аналог бейсиковской команды PRINT. Выводит текст в кодировке UTF8. Позволяет включать тэги в текст и переменные.
Например:
$name="ВАСЯ ПЛЮШКИН";
WB_print("<b>Привет, $name</b>");

WB_br(1);
Команда переноса строки! ОЧЕНЬ НУЖНАЯ КОМАНДА
Параметр в скобках показывает на сколько линий осуществить перенос строки. Пишется после любой команды вывода WAPBASIC.
Аналог тега: <br/>

WB_showline();
Команда вывода линии на экран. Адаптирована для WAP и WAP2.0 (XHTML).

_endalign ();
Команда окончания форматирования текста. Закрывает любой из:
_startalign ();
_startaligncenter ();
_startalignright ();

WB_autoclose ();
Показывает, что документ окончен.

DIE("");
Показывает, что дальше програмного кода нет. Обязательна после: WB_autoclose ();

Фактически, можно использовать такую конструкцию (шаблон):

<?
include ("system.php");
WB_noerrors();
WB_autoheader ("index","Первый файл","0","");
_startalign ();
...КОД PHP, WML, ИЛИ HTML
_endalign ();
WB_autoclose ();
DIE("");
?>

Давайте, посмотрим, какие типы заголовков бывают ещё.
WB_wapheader ("id","title","time","url");
Заголовок для WAP документов. Т.е если сайт ориентирован ТОЛЬКО на WAP.
Закрывается командой: WB_wapclose ();
WB_xhtmlheader ("id","title","time","url");
Заголовок для XHTML (WAP2.0, WEB) документов. Т.е если сайт ориентирован ТОЛЬКО на WAP2.0 или WEB.
Закрывается командой: WB_xhtmlclose ();
В WAPBASIC, есть встроенная переменная, по которой можно определить вошли-ли вы с WAP устройства или с компьютера.
Вот эта переменная: $iswap
Вот код, который проверяет WAP вход или WAP2.0:

if ($iswap=="false") {
WB_print ("ВЫ ТУТ С КОМПА!");
} else {
WB_print ("ВЫ ТУТ С ТЕЛЕФОНА!");
}

Перейдём к рассмотрению дополнительных функций.
WAPBASIC имеет функции простого создание ссылок, картинок, полей ввода текста.
Начнём с ссылки. Если вам знакомы теги HTML, то вы знаете:
Чтобы создать ссылку, нужно написать:
<a href="http://путь_к_сайту">На сайт</a>
Как это неудобно! Посмотрим как это делается в WAPBASIC:
WB_link("http://путь_к_сайту","На сайт");
Правда ведь проще? :)
Теперь вывод картинки:
WB_image ("http://путь_к_картинке","описание");
Создаём поле ввода:
WB_input ("text","test","HELLO","20");
Мы создали поле для ввода текста (text), который будет сохранён в переменную (test),
Начальное значение переменной будет (HELLO), а максимальный размер ввода 20 символов.
Пример:

<?
include ("system.php");
WB_noerrors();
WB_autoheader ("index","Первый файл","0","");
_startalign ();
WB_print("Ваше имя (макс. 20):");
WB_br(1);
WB_input ("text","name","Alex5","20");
WB_br(1);
_endalign ();
WB_autoclose ();
DIE("");
?>

Просто запустите и посмотрите результат!
Вместо параметра text, могут быть следующие параметры:
password - ввод пароля
submit - кнопка отправки формы
И другие, стандартные параметры input.
Кстати, разговор о формах ещё не закончен :)
Внимание! Не забываете ставить после команд вывода WB_br(1);.
Рассмотрим ещё две интересные функции WAPBASIC!
WB_rndword ("имя_файла");
Функция выводит случайную фразу из файла: имя_файла.
Не стану долго описывать функцию, просто приведу пример.
Создайте файл: friends.txt и запишите следующий текст:

ПЕТЯ
ВАСЯ
МАНЯ
ВАНЯ
СЕРЁЖКА
In2W@P.NET

Теперь, сохраните файл. Напишем такой код:

<?
include ("system.php");
WB_noerrors();
WB_autoheader ("index","Первый файл","0","");
_startalign ();
$friend=WB_rndword ("friends.txt");
WB_print ("У вас есть хороший друг: $friend");
_endalign ();
WB_autoclose ();
DIE("");
?>

Теперь запустите и посмотрите полученный код.
Ещё одна полезная функция, позволяет вывести файл на экран. Выводит с тегами и.т.д в кодировке UTF8.
WB_showfile ("имя_файла");
Выводит текст из файла на экран. Поддерживает теги HTML и WML.

Короткое отступление. Или <anchor> и <form>.
Всем, конечно хороши две версии сайта. И WAP радует и WAP2.0 отличный, но есть маленькая проблемка, а именно ФОРМЫ. Поэтому многие и делают только одну версию сайта. Или WAP или WEB.
В WAPBASIC есть удобное решение вывода различных форм, для различных версий сайта (Требует знание WML и HTML).
Итак, чтобы не нарушать дизайн и не использовать сложные XML (XSL) средства, вы можете воспользоваться функцией:
WB_addform("имя_файла_формы");
Как работает данная функция? А очень просто!
Для каждого из вариантов сайта можно создать свою форму.
Приведу пример использования функции:
WB_addform("login");
Данная команда, будет работать сразу с двумя формами, которые вам придётся создать. Для версии WAP: login.wapf, для версии WAP2.0 или WEB: login.webf.
Содержание форм:
login.wapf

Введите ваше имя:<br/>
<input type="text" name="nam" value=""/><br/>
<anchor>Принять
<go href="name.php" method="get">
<postfield name="nam" value="$(name)"/>
</go></anchor><br/>

<form action="name.php" method="get"> Введите ваше имя:<br/>
<input type="text" name="nam" value=""/><br/>
<input type="submit" value="Принять"/><br/>
</form>

Теперь создадим файл name.php и напишем код:

<?
include ("system.php");
WB_noerrors();
$nam=$_GET["nam"]; WB_autoheader ("index","Первый файл","0","");
_startalign ();
WB_print ("Приняли имя: [$nam]");
WB_br(1);
WB_addform("login");
_endalign ();
WB_autoclose ();
DIE("");
?>

Можете посмотреть на результат работы.

ФУНКЦИИ, ОСТАВШИЕСЯ ЗА КАДРОМ.
В WAPBASIC осталось ещё несколько функций, которые ВОЗМОЖНО вам пригодяться.

WB_filecount ("имя_файла");
Функция подсчитывает кол-во записей в файле. Пример:
$myfriends=WB_filecount ("friends.txt");
WB_print ("У меня есть $myfriends друзей!");

_urlredirect ("http://путь");
Функция переадресовывает посетителя на другой сайт.
Пример кода:

<?
include ("system.php");
_urlredirect("http://in2wap.net");
DIE("");
?>

Заметьте! Заголовки не описываются!!! Иначе будет ошибка!

wchrformat ("текст"); и uchrformat ("текст");
wchrformat ("текст"); - переводит текст в кодировку WINDOWS-1251.
uchrformat ("текст"); - переводит текст в кодировку UTF8.
Прелесть этих функций в том, что они работают с любыми кодировками.

browser_type();
Показывает ваш браузер или модель вашего телефона.

Автор очень надеется, что WAPBASIC и данное руководство помогут начать изучение PHP и сделать ваши WAP сайты более привлекательными.
Просьба ко всем пользователям: НЕ ВНОСИТЬ ИЗМЕНЕНИЯ В ИСХОДНЫЙ КОД system.php