Armazenando opções de instância

Ao desenvolver um widget, você pode editar o esquema de opção para criar parâmetros para o widget ou pode criar uma tabela para armazenar opções de instância. Se você editar o esquema de opção existente, todas as opções de instância definidas serão armazenadas no formato JSON no campo Opções adicionais, formato JSON na tabela sp_instance. Os seguintes tipos de campo estão disponíveis:

Para usar outros tipos de campo não compatíveis com o esquema de opção, crie uma tabela de extensão para armazenar seu esquema de opção de widget personalizado. Usar uma tabela permite que você:

Uso de opções em um widget

Acesse opções no widget do script do cliente e do script do servidor usando a variável global de opções. Você pode acessar qualquer valor de opção no client script do widget ou no script do servidor usando opções.optionName.

function() {
  /* widget controller */
  var c = this;
    console.log(c.options.text_color) //Outputs the text_color option for this instance
}

(function() {
     $sp.log(options.text_color) //Logs the value of the text_color option to the browser console.
})();

Definição de opções padrão

Antes de um valor de opção ser definido em uma instância, ele aparece como um valor indefinido quando você acessa essa variável de opção. Use o script do servidor de widget para especificar valores padrão para suas opções.

(function() {
  options.text_color=options.text_color||"blue";
  options.maximum_entry_count=options.maximum_entry_count||5;
})