J3.x:Sviluppo di un componente MVC/Sviluppo di un componente di base
From Joomla! Documentation
< J3.x:Developing an MVC ComponentRevision as of 13:54, 2 November 2021 by Ing Pulizzi (talk | contribs)
Articles in This Series
- Introduction
- Developing a Basic Component
- Adding a View to the Site Part
- Adding a Menu Type to the Site Part
- Adding a Model to the Site Part
- Adding a Variable Request in the Menu Type
- Using the Database
- Basic Backend
- Adding Language Management
- Adding Backend Actions
- Adding Decorations to the Backend
- Adding Verifications
- Adding Categories
- Adding Configuration
- Adding ACL
- Adding an Install/Uninstall/Update Script File
- Adding a Frontend Form
- Adding an Image
- Adding a Map
- Adding AJAX
- Adding an Alias
- Using the Language Filter Facility
- Adding a Modal
- Adding Associations
- Adding Checkout
- Adding Ordering
- Adding Levels
- Adding Versioning
- Adding Tags
- Adding Access
- Adding a Batch Process
- Adding Cache
- Adding a Feed
- Adding an Update Server
- Adding Custom Fields
- Upgrading to Joomla4
Questa è una serie di tutorial su come sviluppare un componente secondo il paradigma Model-View-Controller. Component Versione Joomla!.
Comincia con gli articoli di questa serie delle Introduzioni, e naviga tra gli articoli di utilizzando il pulsante di navigazione in basso o il riquadro a destra (gli Articoli di questa serie).
Note
Questo tutorial fa parte di Sviluppo di un Componente MVC Joomla! 3.x tutorial. Ti invitiamo a leggere le parti precedenti del tutorial prima di leggere questo.
Se hai usato Joomla! prima di leggere questo tutorial, avrai notato che le estensioni vengono installate utilizzando un file compresso ( *.zip ) contenente tutte le cose necessarie per installarle e disinstallarle.
Puoi seguire i seguenti passaggi per creare il componente "Hello World!", oppure puoi scaricare direttamente i file dal repository git archive
Ecco alcune diapositive basate su questi documenti per spiegare come creare elementi di base per potenziare Joomla!
Joomla! Guida dei componenti di base
Joomla! Guida avanzata dei componenti
Ci sono anche una serie di video che accompagnano i passaggi del tutorial, iniziando con
Passaggio 1, sviluppo di un componente di base e puoi accedere alle diapositive utilizzate nella serie di presentazioni video su /presentation/d/11g6qd64zmQObe8xMuEVubdUeIp0DcZ1wr8dq7LcrXIA Slide.
Importante! Intorno alla versione 3.8 gli sviluppatori di Joomla hanno iniziato a cambiare il nome delle classi Joomla e dove erano archiviate nella struttura delle directory. Molti dei passaggi e dei video del tutorial fanno riferimento alla vecchia convenzione di denominazione. Per trovare la nuova classe equivalente e dove è memorizzata, guarda nel tuo file library/classmap.php.
Come aggiungere un componente a Joomla!
In questo articolo tratteremo come creare e installare un Joomla di base! componente. Per questo esempio lavoreremo con il componente " Hello World! "
Per iniziare, devi prima utilizzare il tuo file manager preferito per creare una directory per il componente Hello World! . Questa directory può essere ovunque nel tuo file system, purché sia al di fuori della directory di installazione del tuo Joomla!. Per questo esempio chiameremo la directory com_helloworld, ma questa directory può essere chiamata in qualsiasi modo.
Successivamente, all'interno di questa directory dobbiamo creare alcuni file. Usando il tuo file manager preferito, crea i seguenti file; mentre crei i file, aggiungi il codice sorgente per ogni file che si trova in Dettagli file.
1 | helloworld.xml | questo è un file XML (manifest) che dice a Joomla! come installare il nostro componente. |
2 | site/helloworld.php | questo è il punto di ingresso del sito per il componente Hello World! |
3 | site/index.html | il file index.html impedisce al server web di elencare il contenuto della directory |
4 | admin/index.html | Il file Index.html impedisce al server web di elencare il contenuto della directory |
5 | admin/helloworld.php | Questo è il punto di accesso dell'amministrazione del Componente di Hello World! |
6 | admin/sql/index.html | il File Index.html impedisce al server web di elencare il contenuto della directory |
7 | admin/sql/updates/index.html | Il file Index.html impedisce al server web di elencare il contenuto della directory |
8 | admin/sql/updates/mysql/index.html | impedisce al server web di elencare il contenuto della directory |
9 | admin/sql/updates/mysql/0.0.1.sql | file che consente di inizializzare la versione dello schema del componente com_helloworld. |
Installazione di Hello World! Componente
Usando il tuo file manager preferito, crea un file .zip di questa directory. Per questo esempio chiameremo il file com_helloworld.zip, di nuovo questo file avrebbe potuto essere chiamato qualsiasi cosa.
Ora dobbiamo installare Hello World! componente. Ci sono due modi per farlo, entrambi sono trattati in Installazione di un'estensione. Qui tratteremo il metodo utilizzando l'Extension Manager di Joomla!.
- Utilizzando il tuo browser web preferito, accedi al pannello di amministrazione del tuo Joomla! posto. L'indirizzo sarebbe <yoursite>/joomla/administrator/index.php. Per questo esempio navigheremo su localhost/joomla/administrator/index.php.
*Fai clic su Estensioni → Gestisci → Installa → Carica file pacchetto → Scegli file *Naviga e seleziona file *Fai clic su Carica e installa
Nota: dovresti vedere un messaggio che ti informa se l'installazione è riuscita o meno.
Puoi testare questa funzione di base del componente accedendo a Hello World! pagina per le parti del sito e dell'amministratore del tuo Joomla! sito web.
* Usando il tuo browser web preferito, accedi a Hello World! pagina del componente situata nella parte del sito del tuo sito web. L'indirizzo sarebbe <yoursite>/joomla/index.php?option=com_helloworld. Per questo esempio navigheremo su localhost/joomla/index.php?option=com_helloworld. * Usando il tuo browser web preferito, accedi a Hello World! pagina del componente situata nella parte amministratore del tuo sito web. L'indirizzo sarebbe <yoursite>/joomla/administrator/index.php?option=com_helloworld. Per questo esempio navigheremo su localhost/joomla/administrator/index.php?option=com_helloworld.
Puoi anche notare che il componente Hello World! è visibile nel sito dell'amministratore della tua installazione di Joomla nel menu Componenti.
Dettagli file
admin/sql/updates/mysql/0.0.1.sql è un file vuoto che consente di inizializzare la versione dello schema del componente com_helloworld.
helloworld.xml
<?xml version="1.0" encoding="utf-8"?>
<extension type="component" version="3.0" method="upgrade">
<name>Hello World!</name>
<!-- The following elements are optional and free of formatting constraints -->
<creationDate>January 2018</creationDate>
<author>John Doe</author>
<authorEmail>john.doe@example.org</authorEmail>
<authorUrl>http://www.example.org</authorUrl>
<copyright>Copyright Info</copyright>
<license>License Info</license>
<!-- The version string is recorded in the components table -->
<version>0.0.1</version>
<!-- The description is optional and defaults to the name -->
<description>Description of the Hello World component ...</description>
<update> <!-- Runs on update; New since J2.5 -->
<schemas>
<schemapath type="mysql">sql/updates/mysql</schemapath>
</schemas>
</update>
<!-- Site Main File Copy Section -->
<!-- Note the folder attribute: This attribute describes the folder
to copy FROM in the package to install therefore files copied
in this section are copied from /site/ in the package -->
<files folder="site">
<filename>index.html</filename>
<filename>helloworld.php</filename>
</files>
<administration>
<!-- Administration Menu Section -->
<menu link='index.php?option=com_helloworld'>Hello World!</menu>
<!-- Administration Main File Copy Section -->
<!-- Note the folder attribute: This attribute describes the folder
to copy FROM in the package to install therefore files copied
in this section are copied from /admin/ in the package -->
<files folder="admin">
<!-- Admin Main File Copy Section -->
<filename>index.html</filename>
<filename>helloworld.php</filename>
<!-- SQL files section -->
<folder>sql</folder>
</files>
</administration>
</extension>
site/helloworld.php
Hello World
admin/helloworld.php
Hello World administration
index.html
comune a tutte le cartelle
<html><body bgcolor="#FFFFFF"></body></html>
Contenuto del componente
A questo punto del tutorial, il tuo componente dovrebbe contenere i seguenti file:
1 | helloworld.xml | questo è un file XML (manifest) che dice a Joomla! come installare il nostro componente. |
2 | site/helloworld.php | questo è il punto di ingresso del sito per Hello World! componente |
3 | site/index.html | impedisce al server web di elencare il contenuto della directory |
4 | admin/index.html | impedisce al server web di elencare il contenuto della directory |
5 | admin/helloworld.php | questo è il punto di accesso dell'amministratore a Hello World! componente |
6 | admin/sql/index.html | impedisce al server web di elencare il contenuto della directory |
7 | admin/sql/updates/index.html | impedisce al server web di elencare il contenuto della directory |
8 | admin/sql/updates/mysql/index.html | impedisce al server web di elencare il contenuto della directory |
9 | admin/sql/updates/mysql/0.0.1.sql | file che consente di inizializzare la versione dello schema del componente com_helloworld. |
Un repository git aggiornato che segue questo tutorial è disponibile all'indirizzo https://github.com/Stevec4/Joomla-HelloWorld per qualsiasi descrizione o modifica del codice, si prega di fare una richiesta pull.
Categoria:Joomla! 3.0 Categoria:Joomla! 3.1 Categoria:Joomla! 3.2 Categoria:Joomla! 3.3 Categoria:Joomla! 3.4 Categoria:Sviluppo per principianti Categoria:Sviluppo componenti Categoria:Tutorial Categoria:Tutorial in una serie