Documentació
Primers passos amb Far LMS
D’un WordPress acabat d’instal·lar a la primera venda en tres passos: instal·la l’extensió, connecta Stripe i crea el teu primer curs.
En aquesta pàgina
Abans de començar, necessites: WordPress 6.0 o posterior, PHP 7.4 o posterior i un compte de Stripe (obrir-lo és gratuït). Per cobrar pagaments reals, el teu web ha de funcionar amb HTTPS.
1 Instal·la l’extensió
- Baixa far-lms.zip d’aquesta web. A l’administració del WordPress, ves a Extensions → Afegeix una extensió i fes clic a Puja l’extensió.
- Tria el fitxer far-lms.zip que acabes de baixar, fes clic a Instal·la ara i després a Activa.
- Ja està. En activar-la, Far LMS crea les seves taules a la base de dades i les pàgines que necessita: pagament, escriptori de l’alumne, compra única, inici de sessió, registre i recuperació de contrasenya.
Has comprat un pla de pagament? Després de la compra rebràs un correu amb l’enllaç de descàrrega i la clau de llicència. Puja la versió de pagament de la mateixa manera i introdueix-hi la clau. Els cursos i la configuració es queden com estaven.
2 Connecta Stripe
- Al tauler de Stripe (que és en anglès), obre Developers → API keys i copia la Publishable key (clau pública,
pk_…) i la Secret key (clau secreta,sk_…). Mentre fas proves, fes servir les claus de prova (pk_test_…isk_test_…). - Al WordPress, ves a Far LMS → Configuració i enganxa-hi les dues claus.
- A la mateixa pàgina hi veuràs l’URL del webhook. Copia-la.
- Torna a Stripe, obre Developers → Webhooks, afegeix un endpoint, enganxa-hi l’URL i selecciona aquests esdeveniments:
checkout.session.completed,customer.subscription.created,customer.subscription.updated,customer.subscription.deleted,invoice.paidiinvoice.payment_failed. - Copia el Signing secret de l’endpoint (secret de signatura,
whsec_…), enganxa’l a Far LMS → Configuració i desa els canvis.
A punt per cobrar de debò? Canvia les claus de prova per les reals i torna a crear el webhook en mode real: Stripe té els webhooks de prova i els reals per separat.
3 Crea el teu primer curs
- Ves a Far LMS → Contingut dels cursos i crea el teu curs.
- Afegeix un mòdul, dona-li un objectiu si vols i, a dins, crea seccions i lliçons. A cada lliçó, enganxa l’enllaç del vídeo (YouTube, Vimeo, Wistia, Loom, Dailymotion, Streamable o un fitxer de vídeo) i, opcionalment, un material descarregable.
- Ves a Far LMS → Venda única i posa el preu del curs, o el de tots els cursos junts.
- Obre la pàgina de compra única que ha creat l’extensió i fes una compra de prova amb la targeta de prova de Stripe
4242 4242 4242 4242, qualsevol data futura i qualsevol CVC. - Comprova el resultat: s’ha creat el compte de l’alumne, s’ha enviat el correu de benvinguda i el curs apareix a l’escriptori de l’alumne.
El teu curs, la teva adreça. La pàgina d’un curs pot ser a qualsevol URL. Afegeix [acad_aula_virtual course="course-key"] a qualsevol pàgina i l’aula llegirà el curs del shortcode.
Passos següents
- Dona-li el teu estil. A Far LMS → Personalització, deixa que l’extensió agafi els colors del teu tema o tria tu els colors, el tipus de lletra i l’arrodoniment de les cantonades.
- Mostra xifres en directe. Posa
[acad_figure key="lessons"]a la teva pàgina de vendes i sempre mostrarà quantes lliçons tens. També funciona ambcourses,modules,materialsistudents. - Ven subscripcions. A partir del pla Bàsic, crea plans mensuals o anuals a Far LMS → Plans.
- Necessites ajuda? Si fas servir la versió gratuïta, tens el fòrum de suport de WordPress.org. Si tens un pla de pagament, escriu-nos.
Shortcodes
L’extensió ja et crea les pàgines, així que per començar no els necessites. Són aquí per si vols muntar les teves pròpies pàgines.
| Shortcode | Què mostra |
|---|---|
[acad_aula_virtual course="course-key"] | L’aula virtual d’un curs |
[acad_dashboard] | L’escriptori de l’alumne |
[acad_lifetime_plans] | Les opcions de compra única |
[acad_checkout] | El pas de pagament |
[acad_login], [acad_register] | Inici de sessió i registre |
[acad_lost_password], [acad_reset_password] | Recuperació de contrasenya |
[acad_lesson_index] | Cercador de lliçons per als alumnes que han iniciat sessió |
[acad_figure key="lessons"] | Una xifra en directe per a les pàgines de venda |