J3.x

J3.x:Sviluppo di un componente MVC/Sviluppo di un componente di base

From Joomla! Documentation

< J3.x:Developing an MVC Component
Revision as of 13:54, 2 November 2021 by Ing Pulizzi (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Other languages:
Deutsch • ‎English • ‎Nederlands • ‎español • ‎français • ‎italiano • ‎português do Brasil • ‎русский • ‎العربية • ‎中文(中国大陆)‎ • ‎中文(台灣)‎
Joomla! 
3.x
Tutorial
Sviluppo di un componente MVC



Questa è una serie di tutorial su come sviluppare un componente secondo il paradigma Model-View-Controller. Component Versione Joomla!Joomla 3.x.

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.
Info non-talk.png
General Information

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.x

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