GetSimple CMS Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Советы и рекомендации ======

Если вы разработчик плагинов – вам следует ознакомиться с новой системой обновлений, интегрированной в GetSimple 3.1. Начиная с этой версии, GetSimple уведомляет пользова-теля при появлении новой версии плагина для загрузки в секции сайта GS Extend. При разработке плагина для достижения его совместимости с новой системой необходимо следовать рекомендациям, изложенным в секции ВИКИ [[ru:plugins:update notifications|"Взаимодействие плагинов и секции Extend сайта get-simple.info"]]

===== Определение версии GetSimple =====

Определение версии GetSimple – не такая простая задача, так как единственная доступная функция ''return_site_ver()'', выводящая на экран номер версии в GS 2.03 и возвращающая результат в версии 3.0b уже устарела (прим. переводчика – пометка о том, что данная функция устарела [[themes:template_tags| в списке тэгов англоязычной Вики отсутствует]]). Самый простой способ определить, установлен ли плагин под GetSimple 2.03 или 3.0+:

<code>
$isV3 = function_exists('get_site_version');
</code>

Самый правильный способ определения версии – следующий (используйте его только внутри функций, чтобы не засорять глобальное пространство имен!):
<code>
include(GSADMININCPATH.'configuration.php');
$version = GSVERSION;
</code>

===== Обход отсутствия хука Page-Delete в 2.03 =====

To trigger a function myplugin_function on page deletes in GetSimple 2.03 and 3.0+ use the following code:

<code>
// GetSimple 3.0+
add_action('page-delete', 'myplugin_function'); 

// GetSimple 2.03
if (!function_exists('get_site_version') && basename($_SERVER['PHP_SELF']) == 'deletefile.php') {
  myplugin_function();
}
</code>

===== Success and Error Messages =====

This describes how to display messages in back-end plugin pages.
Assume you have 3 variables, ''$isSuccess'', ''$canUndo'' and ''$msg'' holding the message. To display the message for your plugin ''myplugin'', add the following code to your plugin:

<code>
<?php 
  if (isset($msg)) {
    if ($canUndo) $msg .= ' <a href="load.php?id=myplugin&undo">' . i18n_r('UNDO') . '</a>' 
?>
<script type="text/javascript">
  $(function() {
    $('div.bodycontent').before('<div class="<?php echo $isSuccess ? 'updated' : 'error'; ?>" style="display:block;">'+
            <?php echo json_encode($msg); ?>+'</div>');
    $(".updated, .error").fadeOut(500).fadeIn(500);
  });
</script>
<?php 
  } 
?>
</code>

===== Displaying custom and localized Dates  =====

The publication date in the page XML files is stored in an english text format, which can be converted to a UNIX timestamp with

<code>
$timestamp = strtotime($data->pubDate);
</code>

GetSimple itself uses the ''date'' function to display dates, which will work with other languages only when no weekday or month names are displayed, as these will always be in english.

To display a truly localized date, use:

<code>
$dateLocale = 'de_DE,de,ger,deu';      // or use $LANG or a setting in your plugin, 
                                       // for OS compatibility multiple locales should be possible
$dateFormat = "%A, %d.%m.%Y - %H:%M";  // should be a entry in the i18n language file of your plugin
                                       // for the format see PHP function strftime
$oldlocale = setLocale(LC_TIME, '0');  // save old locale
setlocale(LC_TIME, preg_split('/s*,s*/', $dateLocale))
echo strftime($dateFormat, $date);     // $date is a UNIX timestamp
setLocale(LC_TIME, $oldlocale);        // restore old locale
</code>

===== Working around the broken sitewide cookies in GS 3.0 =====

The important cookie is only valid for path /admin.
There is no (easy?) way to correct the problem for the frontend.
However, if you need it for the backend, e.g. linking to a php somewhere in the plugins folder, you can add the following code to your plugin (e.g. directly after setting up the hooks):

<code>
if (!myplugin_is_frontend() && myplugin_gsversion() == '3.0') {
  // workaround for GetSimple 3.0:
  if (isset($_COOKIE['GS_ADMIN_USERNAME'])) setcookie('GS_ADMIN_USERNAME', $_COOKIE['GS_ADMIN_USERNAME'], 0, '/');
}

function myplugin_is_frontend() {
  return function_exists('get_site_url');
}

function myplugin_gsversion() {
  @include(GSADMININCPATH.'configuration.php');
  return GSVERSION;
}
</code>
Замените //myplugin// наименованием своего плагина.

====== Ссылки ======

На главную [[ru:|Содержание]]

===== Страницы этой секции =====

=== Разработка плагинов ===
  *[[ru:plugins:creation|Создание плагинов ]]
  *[[ru:plugins:extend_api|Работа с  Extend API ]]
  *[[ru:plugins:hooks_filters|Хуки и фильтры]]
  *[[ru:plugins:tabs_menus|Вкладки и боковые меню]]
  *[[ru:plugins:update_notifications|Взаимодействие плагинов и секции Extend сайта get-simple.info]]
GetSimple CMS Wiki

User Tools

Site Tools

Page Tools
