Guide de migration de la version Chiba 1 à la version Chiba 2

Mettre à jour son Novius OS et ses applications

Reportez-vous à la page Mise à jour si vous ne l’avez pas encore fait.

Modification de vos développements

Ruptures de compatibilité

Model : les colonnes d’un dataset sont encodées

Si une colonne d’un dataset contient du HTML, vous devez ajouter un paramètre isSafeHtml pour ne pas qu’elle soit encodée.

 <?php
 return array(
     'data_mapping' => array(
         // ...
         'column_with_html' => array(
             'title' => 'Column with HTML',
             'column' => 'col_html',
             'isSafeHtml' => true,
         ),
         // ...
     ),
 );

CRUD : le callback success est appelée après le save

Dans le CRUD, à la mise à jour d’item, la fonction de callback success est appelée après le save (pas avant), comme pour la création. Si vous utilisez success dans vos développements, vérifier que votre code soit compatible avec un appel après le save.

Attachment : ->url() et ->urlResized() retournent des URL absolues

Les méthodes ->url() et ->urlResized() retourne maintenant des URL absolues. Vous avez 2 possibilités de modification de vos développements :

  • Vérifier que vous ne concateniez pas le base_url devant l’appel de ces méthodes.

  • Ajouter un paramètre égal à false dans l’appel de la méthode.

    <?php
    
    $attachement->url(false);
    

Voir aussi

Attachment

Comments : Les commentaires sont maintenant contextable

La migration essaye de deviner le contexte des commentaires existants, mais si vous avez implémenté les commentaires sur un modèle non contextable, la migration ne pourra rien. Dans ce cas vous devrez assigner vous-même les contexts aux commentaires (colonne comm_context de la table nos_comment) si vous voulez les voir dans l’interface d’administration.

Blog/News : La taille par défaut des vignettes change et elles sont cliquables

  • La taille par défaut change de 200 à 120 pixels sur la liste, toujours 200 pour la fiche.
  • Les vignettes sont cliquables.

Si vous voulez revenir à la configuration précédente :

  • Étendez le fichier de configuration correspondant files noviusos_blog::config ou noviusos_news::config

  • Modifier la configuration de cette façon :

    <?php
    
    return array(
        'thumbnail' => array(
            'front' => array(
                'list' => array(
                    'link_to_item' => false,
                    'max_width' => 200.
                ),
                'item' => array(
                    'link_to_fullsize' => false,
                ),
            ),
        ),
    );
    

URL Enhancer: Methode getUrlEnhanced() obligatoire

Tous les URL enhancers doivent implémenter une méthode getUrlEnhanced().

Dépréciés

Une mise en conformité n’est pas obligatoire mais souhaitable pour pouvoir migrer sans soucis lors de prochaine version.

Enhancer : get_url_model($item, $params) devient getURLEnhanced($params)

Code déprécié :

<?php

public static function get_url_model($item, $params = array())
{
    $model = get_class($item);

    switch ($model) {
        case 'A\Class':
            return $item->virtual_name).'.html';
            break;
    }

    return false;
}

À remplacer par :

<?php

public static function getURLEnhanced($params = array())
{
    $item = \Arr::get($params, 'item', false);
    if ($item) {
        $model = get_class($item);

        switch ($model) {
            case 'A\Class':
                return $item->virtual_name).'.html';
                break;
        }
    }

    return false;
}

Media : Changement dans l’API de Model_Media

Toutes les méthodes en snake_case sont dépreciées :

  • delete_from_disk devient deleteFromDisk
  • delete_public_cache devient deleteCache
  • get_path devient _getVirtualPath
  • get_private_path devient path
  • get_img_tag devient htmlImg
  • get_img_tag_resized devient htmlImgResized
  • is_image devient isImage
  • get_public_path devient url
  • get_public_path_resized devient urlResized

Voir aussi

Methods

Media : Changement dans l’API de Model_Folder

  • delete_from_disk devient deleteFromDisk
  • delete_public_cache devient deleteCache

Voir aussi

Methods

L’événement user_login

L’événement user_login est déprécié, utiliser admin.loginSuccess à la place.

Voir aussi

admin.loginSuccess

Migration Chiba 2 à Chiba 2.1

Nouveau dans la version Chiba: 2.1

Dépréciés

Une mise en conformité n’est pas obligatoire mais souhaitable pour pouvoir migrer sans soucis lors de prochaine version.

Renderer_Selector->set_renderer_options()

La methode set_renderer_options() est dépréciée et devient setRendererOptions().

Renderer_Media->parse_options()

La methode parse_options() est dépréciée et devient parseOptions().

Slideshow : vues et configuration front-office

  • Le fichier de configuration noviusos_slideshow::slideshow a été réorganisé afin de mieux séparé les différents formats de diaporama. Voir la documentation d’API de Slideshow.
  • Le fichier de configuration noviusos_slideshow::flexslider est déprécié et devient noviusos_slideshow::formats/flexslider.
  • La vue noviusos_slideshow::slideshow_js est déprécié et devient noviusos_slideshow::flexslider/javascript instead.
  • La vue noviusos_slideshow::slideshow est déprécié et devient noviusos_slideshow::flexslider/slideshow instead.

La version Chiba 2.1 de l’application Slideshow a des migrations en base de données a effectuer. Voir Lancer la migration.

Read the Docs v: chiba.2
Versions
latest
stable
elche
dubrovka
chiba.2
chiba.1
Downloads
pdf
htmlzip
epub
On Read the Docs
Project Home
Builds

Free document hosting provided by Read the Docs.