Actions

LimeStore extension development: Difference between revisions

From LimeSurvey Manual

Line 22: Line 22:


All LimeSurvey extensions include a <code>config.xml</code> file with specifies author, version, type, and so on. Without this file, LimeSurvey won't be able to properly install the extension.
All LimeSurvey extensions include a <code>config.xml</code> file with specifies author, version, type, and so on. Without this file, LimeSurvey won't be able to properly install the extension.
{| class="wikitable"
|+ Metatable tags descriptions
!Tag
!Type
!Mandatory
!Description
|-
| name || string || x || The name of the extension
|-
| type || string || x || Type of the extension; can be "plugin", "theme", TODO
|-
| creationDate || date || || Date the extension was created
|-
| lastUpdate || date || || Date of the latest update
|-
| author || string || x || Plugin author
|-
| authorUrl || url || || URL to author web page
|-
| version || semantic version || x || Extension version number, as semantic versioning
|-
| lastSecurityUpdate || semantic version || || Last version that included a security update
|-
| license || string || || Extension licence
|-
| Description || CDATA || || Short description of extension, visible in the LimeSurvey extension manager
|}


=== Plugin example ===
=== Plugin example ===
Line 31: Line 59:
         <type>plugin</type>
         <type>plugin</type>
         <creationDate>2017-03-28</creationDate>
         <creationDate>2017-03-28</creationDate>
         <last_update>2018-01-24</last_update>
         <lastUpdate>2018-01-24</lastUpdate>
         <author>Olle Haerstedt</author>
         <author>Olle Haerstedt</author>
         <authorUrl>https://www.limesurvey.org</authorUrl>
         <authorUrl>https://www.limesurvey.org</authorUrl>

Revision as of 12:57, 8 January 2019

This page describes how you as a third-party developer can create and publish extensions for LimeSurvey, available for purchase or free download in the LimeSurvey LimeStore.

FAQ

What is the LimeStore

TODO

How do I become a third-party developer?

Apply at us, sign documents, give banking details/PayPal account for transactions, etc.

TODO

Adding an extension to the LimeStore

First, you have to be approved as a LimeStore extension vendor. See above.

The extension has to be zipped correctly, with a proper config.xml file. See below.

config.xml specification

All LimeSurvey extensions include a config.xml file with specifies author, version, type, and so on. Without this file, LimeSurvey won't be able to properly install the extension.

Metatable tags descriptions
Tag Type Mandatory Description
name string x The name of the extension
type string x Type of the extension; can be "plugin", "theme", TODO
creationDate date Date the extension was created
lastUpdate date Date of the latest update
author string x Plugin author
authorUrl url URL to author web page
version semantic version x Extension version number, as semantic versioning
lastSecurityUpdate semantic version Last version that included a security update
license string Extension licence
Description CDATA Short description of extension, visible in the LimeSurvey extension manager

Plugin example

<config>
    <metadata>
        <name>MassAction</name>
        <type>plugin</type>
        <creationDate>2017-03-28</creationDate>
        <lastUpdate>2018-01-24</lastUpdate>
        <author>Olle Haerstedt</author>
        <authorUrl>https://www.limesurvey.org</authorUrl>
        <version>1.0.0</version>
        <lastSecurityUpdate>1.0.0</lastSecurityUpdate>
        <license>GNU General Public License version 2 or later</license>
        <description><![CDATA[Edit multiple relevance equations in one page.]]></description>
    </metadata>
</config>

Theme example

TODO