Gawing compatible ang iyong plugin sa LS4

Mga teknikal na pagbabago

Ang bagong XML config file

Mula sa LimeSurvey 4.0, kailangan ng mga plugin ng XML config file upang mapatakbo sa application.

Ang dahilan nito ay ang posibilidad na mag-imbak ng meta-data tulad ng Author ng plugin, support email, o impormasyon tungkol sa mga updater.

Mandatoryo ang XML file na ito sa LimeSurvey 4. Dapat itong nasa root directory ng plugin. Para sa karagdagang impormasyon, tingnan ang pagbuo ng plugin: mga plugin

Halimbawa:

Ang bagong plugin directory

Nagbago ang plugin directory sa LimeSurvey 4. Dahil sa seguridad, matatagpuan na ngayon ang plugin directory sa upload directory (/upload/plugins) dahil sa bagong plugin manager (Plugin uploader). Para sa manu-manong pag-upload, inirerekomenda naming i-upload ang iyong mga file sa bagong directory upang maiwasan ang hindi tamang paggana ng software.

Tiyaking baguhin o idagdag ang bagong directory kung naka-hard-code ito sa iyong plugin.

Halimbawa:

Ang mga bagong plugin event

Ilang plugin event mula sa LS3 ay deprecated na. Gamitin ang mga bagong plugin event na ipinakilala sa LS4 bilang kapalit ng mga lumang plugin event. Para sa karagdagang impormasyon, tingnan ang aming development manual tungkol sa mga plugin event.

Mga deprecated na function at method

Dahil nagbago ang code base o istruktura ng LimeSurvey 4, marami nang method o function na hindi na ginagamit. Upang malutas ito, kailangan mo munang i-enable ang debug mode sa config.php file at pagkatapos ay pumunta sa pahina ng plugin. Anumang method na wala na ay ipapakita sa error page.

Ang ilan sa mga method ay pinalitan ng pangalan sa LS4 o hindi na ginagamit. Para matiyak na gumagana ang iyong plugin sa parehong LS3 at LS4, suriin ang bersyon ng LS bago tawagin ang method na kailangan mo.

Halimbawa:

Pinakamahusay na Gawi

Iwasan ang mga SVG file

Dahil sa seguridad (XSS), hindi posible ang pag-upload ng mga SVG file. Hindi papansinin ng Plugin uploader ang mga SVG file. Palitan ang mga ito ng PNG o JPEG file. Posible lamang ang pag-upload ng mga SVG file kung may access ka sa installation directory sa pamamagitan ng ftp o iba pang server tool (Mag-upload ng anumang file sa sarili mong panganib).

Iwasan ang mga global constant

Iwasan ang paggamit ng mga global constant na maaaring sumalungat sa mga variable ng core application o ng ibang plugin tulad ng „ROOT_PATH“. Huwag gumamit ng global constant sa pangkalahatan sa pagbuo ng plugin.

Gumamit ng mga Namespace

Gumamit ng namespace para sa mas maayos na organisasyon sa pamamagitan ng pagpapangkat ng mga class na magkakasamang gumagawa ng isang gawain sa iyong plugin. Sa ganitong paraan, maiiwasan mong gumamit ng mga class na ginagamit na sa core application.

Halimbawa: