Файл config.xml

Элемент widget

Элемент-контейнер, который заключает в себе все остальные элементы файла config.xml.

Элемент name

Содержит название расширения.

Элемент description

Содержит описание предназначения расширения.

Элемент author

Содержит информацию об авторе расширения.

Элемент license

Содержит лицензию на использование расширения.

Элемент icon

Указывает файл иконки расширения.

Элемент content

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

Элемент feature

Определяет некоторые свойства расширения, такие как, например, возможность отображения в Экспресс-панели.

Элемент preference

Позволяет разработчику установить настройки. Эти данные хранятся в виде пары имя-значение и доступны в расширении через интерфейс widget.preferences.

Элемент access

Позволяет авторам дать расширению доступ к внешним сетевым ресурсам.

Элемент span

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

Атрибут xml:lang

Указывает язык текста элемента.

Атрибут dir

Задает направление текста элемента.

Краткий обзор

Обязательный файл config.xml дает браузеру Opera такую важную информацию, как название, описание и версия расширения.

Большая часть сведений (например, название, описание, имя автора расширения), кроме того, может пригодиться пользователю, т.к. она отображается в различных элементах пользовательского интерфейса.

Корректный файл config.xml является обязательным для любого расширения браузера Opera.

Подробную документацию о config.xml смотрите здесь:

• W3C Widgets Packaging and Configuration Specification
• W3C Widget Access Request Policy

Пример

Ниже дан пример файла config.xml, содержащего обычные элементы данных: название расширения, имя автора и описание. Среди прочих в файле есть следующие два важных элемента:

<feature> element

Поскольку расширение должно демонстрировать новости блога Choose Opera blog в Экспресс-панели, данный элемент указывает, что будет использоваться свойство "opera:speeddial".

<access> element

Чтобы получать последние новости с http://my.opera.com, используется элемент access, запрашивающий доступ для обмена и получения информации со всего домена.

<?xml version="1.0" encoding="utf-8"?>
<widget xmlns="http://www.w3.org/ns/widgets" id="http://my.opera.com/chooseopera/xml/rss/blog/" viewmodes="minimized" version="1.0">

  <name>Opera news</name>

  <author>John Smith</author>
  <description>Stay up to date with the latest news from Opera, served to you inside Speed Dial</description>
  <icon src="images/icon.64x64.png"/>

  <feature name="opera:speeddial" required="true">
    <param name="url" value="http://my.opera.com/chooseopera/blog/"/>
  </feature>

  <access origin="http://my.opera.com/" subdomains="true"/>
 	
</widget>

Рисунок 1: Так отображается информация о расширении, находящаяся в файле config.xml.

Рисунок 1 демонстрирует окно управления расширением, в котором указана информация, полученная из показанного выше файла config.xml.

Как видно из примера, большая часть информации, находящейся в файле config.xml, помогает пользователю узнать различные подробности о расширении. В следующих разделах описаны другие элементы и атрибуты, о которых нужно знать при создании файла config.xml.

Для дополнительного чтения

Читайте статью на Dev.Opera Азы config.xml, детально описывающую работу с файлом config.xml.