Gyakran ismételt kérdések

Minta a ContKing véleményküldő modul beépítésére

A tartalmad szövege, amiről visszajelzést szeretnél kapni

A beépítendő kód:

<link href="https://feedback.contking.com/feedback.css" rel="stylesheet" type="text/css">
<script src="https://feedback.contking.com/feedback.js" type="text/javascript"></script>
...
<div id="contking-feedback-container"></div>

Milyen 3rd party library szükséges a plugin működéséhez?
Egyedül a jQuery szükséges a plugin működéséhez.
Figyelj, hogy
  1. a jQuery a feedback.js előtt legyen a HTML kódban beimportálva
  2. a jQuery legyen elérhető a $ változón keresztül
  3. a feedback.js a head-ben legyen beimportálva, ne a body-ban

Összeakadhat-e a plugin saját, vagy más 3rd party library kóddal?
A plugin saját változókat definiál egyedi néven, így az összeakadás lehetősége elenyésző.

Befolyásolhatja-e a plugin css-e az oldalam kinézetét
A css egyedi selector neveket definiál, valamint nem használ semmilyen külső template-et, így az oldal kinézetén nem fog változtatni.

Átszabhatom a plugin kinézetét az oldalam stílusához igazítva?
Igen. A feedback.css csak egy minta, ezt felhasználva szabadon átszabható a felület.

Módosíthatom a plugin működését?
A feedback.js módosítása hibás adat küldést okozhat, melyért a ContKing nem vállal felelősséget. A plugin módosítása nem javasolt.

Le akarom tiltani a plugin bizonyos funkcióit. Hogyan tehetem meg?
Szavazó modul letiltása
A következő css legyen definiálva a feedback.css importálása után:
.contking-feedback-vote {
display: none;
}
Vélemény küldő modul letiltása
A következő css legyen definiálva a feedback.css importálása után:
.contking-post-comment {
display: none;
}
Bármilyen ContKing-re való hivatkozásnak láthatónak kell maradnia, azokat elrejteni nem szabad!

Megjeleníthetek egy oldalon több plugin-t?
Jelen pillanatban egy oldalon egy box jelenhet meg.

Szavazáskor, illetve vélemény küldéskor tud egyedi paramétereket tárolni a rendszer?
A plugin betöltésekor definiálhatunk plusz paramétereket, melyeket minden kéréskor elküld a szerver felé, így plusz információt szolgáltatva a szavazás vagy vélemény küldés körülményeiről.
Ehhez a következő javascript kódot kell elhelyezni közvetlenül a feedback.js beimportálása után:
<script>
ContKingFeedback.siteParameters = 'saját paraméterek';
</script>
Az adatnak a string-en belül nincs meghatározott formátuma, szerepelhet benne sima string, urlencoded paraméter lista, csv, json string, vagy bármi más.
A string hossza elméletileg 2000 karakter lehet, azonban a plugin által indított ajax kérés böngészőtől függően korlátokba futhat, a hivatalos ajánlás szerint 255 karakternél rövidebbnek kell lennie egy HTTP request-nek. 200 karakter alatt tartva ezt a paramétert elvileg semmilyen HTML5 kompatibilis böngészőben nem szabad hibának előfordulnia.

Átállíthatom a plugin-ban megjelenő szöveg nyelvét?
Igen, jelenleg a plugin magyar és angol nyelven tud megjelenni.
Ehhez a következő javascript kódot kell elhelyezni közvetlenül a feedback.js beimportálása után:
<script>
ContKingFeedback.language = 'en';
</script>
Ezzel angolul fog megjelenni, a magyar nyelv kódja: 'hu'.

Átírhatom a plugin-ban megjelenő szöveget?
Igen, a ContKing feliratot leszámítva minden más testre szabható.
Ehhez a következő javascript kódot kell elhelyezni közvetlenül a feedback.js beimportálása után:
<script>
ContKingFeedback.language = 'custom';
ContKingFeedback.translator.custom = {
title: '',
vote: {
title: '',
yes: '',
no: '',
success: '',
fail: ''
},
comment: {
title: '',
name: '',
email: '',
comment: '',
send: '',
success: '',
fail: ''
}
}
</script>
Ezzel a módszerrel minden szöveget egyszerre kell átírni!

Példa az alap magyar szöveg fordító objektumára:
{
title: 'Visszajelzés',
vote: {
title: 'Hasznos volt ez a tartalom?',
yes: 'Igen',
no: 'Nem',
success: 'Köszönjük a szavazatodat',
fail: 'Hiba történt a szavazat leadás közben'
},
comment: {
title: 'Küldd el a véleményedet',
name: 'Neved *',
email: 'E-mail címed *',
comment: 'Véleményed *',
send: 'Küldés',
success: 'Köszönjük a véleményedet',
fail: 'Hiba történt a vélemény küldés közben'
}
}

Szolgáltathatom saját szerverről a plugin-t?
Igen, azonban a ContKing a plugin, illetve a mögötte levő rendszer változtatásáról nem küld figyelmeztetést, így ebben az esetben rendszeresen ellenőrizni kell, hogy elérhető-e újabb verzió

Nem jelenik meg a plugin. Mi a hiba?
A következő hibák fordulhatnak elő a plugin implementálásakor:
A plugin nem töltődött be
Megoldás: Ellenőrizd, hogy a plugin be van-e importálva a HTML kódban, illetve elérhető-e azon az url-en
A böngésző letiltotta a feedback.js-t
Ez akkor fordul elő, ha SSL mögött van az oldal (https kapcsolat), azonban a plugin http kapcsolaton keresztül van bekérve.
A Chrome ekkor a következő hibaüzenetet adja a konzolban:
Mixed Content: The page at 'https://feedback.contking.com/feedback/test/' was loaded over HTTPS, but requested an insecure resource 'http://feedback.contking.com/feedback.js'. This request has been blocked; the content must be served over HTTPS.
Megoldás: A plugin lehetőleg mindig az oldallal azonos típusú http kapcsolaton keresztül legyen bekérve
A jQuery nem érhető el $ néven a feedback.js futásakor
Vagy egyáltalén nincs importálva a jQuery, vagy nem $ néven érhető el (ekkor tipikusan jQuery néven lehet elérni), vagy nem a feedback.js előtt lett beimportálva.
A Chrome ekkor a következő hibaüzenetet adja a konzolban:
Uncaught ReferenceError: $ is not defined
Ellenőrzés: A konzolba beírni a következő parancsot, majd ENTER:
$
Ha az eredmény az undefined, vagy az Uncaught ReferenceError: $ is not defined üzenet, akkor nem érhető el $ néven. Ha az eredmény úgy kezdődik, hogy function (, akkor elérhető, ellenkező esetben ellenőrizni kell a jQuery változót is a következő paranccsal:
jQuery
Ha az eredmény itt is valamelyik fenti üzenet, akkor nincs a jQuery beimportálva az oldalra. Azonban ha az eredmény úgy kezdődik, hogy function (, akkor elérhető, de jQuery néven.
Megoldás:
Ha $ néven elérhető: Nem a feedback.js előtt lett beimportálva, meg kell változtatni az importálások sorrendjét
Ha jQuery néven érhető el: Definiálni kell a $ változót a jQuery conflict feloldásával:
<script>
$ = jQuery.noConflict();
</script>
Ha egyik néven sem érhető el, akkor be kell importálni a feedback.js előtt
A feedback.js nem a head részben van beimportálva
Megoldás: a head részben kell beimportálni a jQuery után, ebből adódik, hogy a jQuery-t is a head részben kell beimportálni.
A container nem szerepel a HTML kódban
Megoldás: a <div id="contking-feedback-container"></div> kódot elhelyezni a HTML kódban ott, ahol meg szeretnénk jeleníteni.

Megjelenik a plugin, de szét van esve a felülete
Megoldás: nem érhető el sem a feedback.css, sem egyedi fejlesztésű stíluslap. Elérhetővé kell tenni valamelyiket. Amennyiben egyedi stíluslap van fejlesztve és az elérhető, ellenőrizni kell, hogy nincs-e benne hiba.
Ha nem a ContKing szerveréről van szolgáltatva a feedback.js vagy a feedback.css, illetve egyedi stíluslap van fejlesztve, akkor előfordulhat, hogy egy újabb verziójú feedback.js miatt már nem kompatibilis a régi js/css az új css-el/js-el.
Ebben az esetben a weboldal fejlesztőjének felelőssége, hogy up-to-date tartsa a plugin-t és minden függőségét

További kapcsolódó kategóriák: