Traduzione italiana del file readme.txt del modulo Content Profile.

Di seguito la traduzione in italiano che ho fatto del file readme.txt del modulo Content Profile.
Se qualcuno ha qualche suggerimento non esitate a segnalarlo ed eventualmente modificherò la traduzione.

------------------------------------------------------------------------------------------------------------------
$Id: README.txt,v 1.1.2.11 2010/01/12 12:08:49 fago Exp $

-----------------------

Modulo Content Profile

-----------------------

by Wolfgang Ziegler, [email protected]

Traduzione: Fabrizio Procopio, [email protected]

Con questo modulo si possono creare profili utente utilizzando i tipi di contenuto di drupal.

Installazione

------------

* Copiare la cartella del modulo in quella dedicata ai moduli di drupal e attivare il modulo.

Utilizzo:

--------

* Ti ritroverai con un nuovo tipo di contenuto chiamato "Profilo". Personalizza le sue impostazioni andando all'indirizzo drupal

admin/content/types.

* Una volta installato il modulo, nella parte inferiore di ogni tipo di contenuto troverete una casella, che se vistata consente

di marcare un tipo di contenuto come "profilo".

* Quando si marca un tipo di contenuto come "profilo" verrà generata una ulteriore scheda "Contenuto profilo", la quale fornirà di impostare specifiche impostazioni per il contenuto profilo.

Avviso:

---------

Il modulo utilizza i "nodi" (o contenuti) del core di drupal come profili utenti, pertanto i permessi di accesso applicati per vedere i contenuti profili corrispondono a quelli standard relativi al nodo.

Ciò comporta che il permesso relativo ad "accede ai profili utente" del modulo utente resta valido per le pagine account dell'utente (cioè ad esempio "user/UID") ma non ai contenuti profili, per accedere ai quali bisogna puntare all'indirizzo interno node/NID. Inoltre resta possibile utilizzare qualunque modulo di accesso ai normali nodi per regolare gli accessi ai contenuti profilo. Ad esempio è possibile utilizzare il modulo Content Access (http://drupal.org/project/content_access).

Content profiles per role:

--------------------------

Potrebbe capitare, ma potrebbe anche non succedere, di impostare come contenuto profilo più di un tipo di contenuto. Personalizzando i permessi per quei tipi di contenuto diventa possibile creare differenti profili per differenti ruoli.

Dritte:

------

* Nell'usare il modulo content profiles il campo "titolo" risulta spesso fastidioso. E' possibile rinominarlo all'interno delle impostazioni del tipo di contenuto oppure andando al link -content profile- (/admin/content/node-type/profile/profile) nasconderlo nel modulo e generarlo automaticamente utilizzando il modulo auto nodetitle http://drupal.org/project/auto_nodetitle.

* Per linkare un contenuto profilo di un utente, è possibile puntare a

"user/UID/profile/TYPE" laddove UID è l'id dell'utente e TYPE è il nome del tipo di contenuto leggibile dalla macchina, un esempio potrebbe essere "user/1/profile/profilo".

Questo indirizzo funziona a prescindere se l'utente ha già creato un contenuto profilo o meno.

* Se vuoi modificare la veste grafica del tuo contenuto profilo, puoi farlo come per qualunque altro tipo di contenuto. A tal riguardo leggi http://drupal.org/node/266817.

* Se vuoi rendere un contenuto profilo privato in un sito dove i contenuti sono disponibili al pubblico, allora ti serve un modulo che consenta un agranularità più fine degli accessi come ad esempio il modulo Content Access (http://drupal.org/project/content_access) il quale lo consente.

* E' possibile anche integrare regole utili per la personalizzazione del comportamento del modulo. In merito a ciò leggi oltre.

Personalizzazione dei temi: usa facilmente informazioni di profilo nei tuoi template!

-----------------------------------------------------------

Content Profile aggiunge una nuova variabile $content_profile per la maggior parte dei template relativi agli utenti. Questa variabile consente un facile accesso ai dati contenuti nei profili utente.

Inoltre essa fa il suo lavoro velocemente caricando in cache i contenuti i nodi contenuto profilo necessari.

La variabile $content_profile è disponibile per le pagine, nodi, commenti, user_name,

user_profile, user_signature, search_result ed altri template.

$content_profile ti permette di accedere a tutte le variabili di un profilo, che sei solito utilizzare in un classico template di un nodo. Leggi http://drupal.org/node/11816.

Così in ognuno di questi template è possibile impiegare $content_profile in questo modo:

<?php
 // Just output the title of the content profile of type 'profile'
 // If there is no such profile, it will output nothing.
 echo $content_profile->get_variable('profile', 'title');
 // Get all variables of the content profile of type 'profile'
 $variables = $content_profile->get_variables('profile');
 // Print out a list of all available variables
 // If the user has no profile created yet, $variables will be FALSE.
 print_r($variables);
 if ($variables) {
   // Print the title and the content.
   echo $variables['title'];
   echo $variables['content'];
 }
 else {
   // No profile created yet.
 }
 // $content_profile also allows you to easily display the usual content profile's view
 // supporting the same parameters as node_view().
 echo $content_profile->get_view('profile');
?>

Controlla il sorgente di content_profile.theme_vars.inc per vedere quali ulteriori metodi supporta $content_profile

Aggiungere $content_profile ad ulteriori template

--------------------------------------------

Se dovesse mancarti $content_profile in qualche template contenente le informazioni dell'utente (id),

aggiungi una richiesta alla coda di content profile e noi l'aggiungeremo al modulo.

Inoltre puoi fare in modo che content_profile si aggiunga al tuo template personalizzato specificando

le impostazioni 'content_profile_extra_templates' nel file settings.php del tuo sito.

Ad esempio puoi aggiungere:

$conf['content_profile_extra_templates'] = array('my_template');

dove 'my_template' rappresenta la chiave della entry del tuo template nel theme_registry (hook_theme()).

Integrazione col modulo Rules

------------------

Esiste qualche integrazione con il modulo rules (http://drupal.org/project/rules), la quale offre

una condizione per verificare se un utente ha già creato un profilo di un certo tipo. Questa integrazione permette un'azione per caricare il contenuto profilo di un utente, il quale lo rende disponibile alle sostituzioni di token così come anche a tutte le altre azioni/regole esistenti che interagiscono col contenuto.

Pertanto questa integrazione permette di costruire regole relativi ai profili per mezzo del modulo rules. Ad esempio il modulo viene installato con la seguente regola:

"Reindirizza alla pagina di creazione profilo, se l'utente non ha un profilo."

disattivata di default.

Attivandola alla pagina "Triggered rules", è da valutare quando un utente

si autentica. Ovviamente tu puoi anche alterare la regola di default e personalizzarle in modo da adattarla ai tuoi bisogni,

Ad esempio: puoi rimuovere il reindirizzamento e mostrare solo un messaggio.

---------------------------------------------

Content Profile User Registration Integration

----------------------------------------------

Vi è una piccola estensione del modulo module acclusa nel modulo principale, la quale permette di abilitare la l'integrazione della registrazione per content profile.

Questo modulo è costruito sul modulo principale di content profile. Esso permette di integrare

di uno o più content profile nella pagina di registrazione degli utenti.

Installazione

------------

* Attiva il modulo.

* Assicurati di leggere le note di utilizzo che seguono!

Utilizzo:

--------

* Quando modifichi un profile content type ti ritroverai una ulteriore scheda chiamata "Content profile".

Essa serve per le impostazioni specifiche di quello specifico content profile. VI è ora un nuovo field group

chiamato "User Registration" il quale ti permette di abilitare questa funzionalità per un content profile.

* Non bisogna assolutamente permettere agli utenti anonimi di creare un content profile. Se lo fai,

gli utenti anonimi potrebbero creare profili anonimi senza registrazione.

* Se utilizzi il modulo "Content permissions", incluso con CCK, assicurati di permettere l'accesso

a quei campi che dovrebbero apparire agli utenti anonimi.

* Il peso del profilo (configurabile nelle impostazioni content profile) controlla la posizione

degli elementi della form nella pagina di registrazione.

* E' possibile anche nascondere alcuni degli elementi della form di registrazione nelle impostazioni.

Fondamentalmente è permesso nascondere sia tutti i campi CCK non rihiesti e sia il cmapo titolo.

Se il titolo viene nascosto esso mostrerà il nome dell'utente.

* Per maggiori controlli sul titolo è possibile utilizzare il modulo the "Automatic Nodetitles", scaricabile

all'indirizzo http://drupal.org/project/auto_nodetitle. Esso si integra bene con il presente modulo.

* Nascondere i campi CCK richiesti non è una funzione supportata in quanto i nodi creati risulterebbero

mancanti di campi obbligatori renderebbe impossibile ad un amministratore modificarli.

* Pertanto l'opzione "Hide other form elements" ("Nascondi gli altri elementi del modulo") ti permettedi nascondere

tutti gli elemnti del modulo non elencati qui tranne i campi CCK richiesti obbligatori.

Tuttavia i campi CCK obbligatori possono essere comunque nascosti rendendoli inaccessibili agli utenti anonimi

utilizzando il modulo "Content permissions" relativo a CCK. AD ogni modo fai attenzione a questa operazione - potresti

anche restringere di conseguenza l'accesso ad altri ruoli.

* Se desideri nascondere il campo "corpo", ti basta rimuoverlo dal tipo di contenuto in generale nella pagina

delle impostazioni del tipo di contenuto. Dopo di che crea un campo testuale CCK che potrai tranquillamente nascondere.

* E' possibile abilitare l'integrazione della registrazione per profili multipli - comunque fai attenzione affinché

gli elementi condivisi dei moduli come ad esempio il titolo, appaiano solo una volta e tutti i nodi profili creati abbiano

lo stesso valore assegnato.

* Per percorsi di registrazioni multiple relativi a ruoli differenti il modulo AutoAssignRole può tornare utile:

http://drupal.org/project/autoassignrole. Esso si integra con il modulo Content Profile Registration Integration,

in questo modo potrai selezionare quale profile dovrà apparire su ofni percorso di di AutoAssignRole (configurabile

nelle impostazioni di content profile). E' necessaria una versione di AutoAssignRole con rilascio successivo al 4 giugno 2009.

* Se vuoi prepopolare altri elementi di moduli, si possono nascondere i campi CCK tramite il modulo rules http://drupal.org/project/rules.

Configura un ruolo, che reagisce alla creazione di un content profile (event) popola i tuoi valori di campo (action).

* Porre l'upload di file nei moduli di registrazione non è supportato anche perché probabilmente non funzionerebbe correttamente.

* L'opzione CCK "Aggiungi più campi" funziona solo per queli utenti che hanno attivato javascript nel modulo di registrazione.

Gli utenti privi di javascript non potranno aggiungere altri campi. Gli sviluppatori interessati possono troavre materiale qui http://drupal.org/node/634984

-----------------------

Content Profile Tokens

-----------------------

Autore originale: @author Ádám Lippai - Oghma ltd. ([email protected])

Questo è un piccolo modulo che aggiunge tokens per content profile ai campi CCK di testo numerici sia per un utente

sia ai moduli 'flag friend' 'requester' e 'requestee'.

AVVISO: Questo modulo rallenta la generazione degli user tokens, pertanto potrebbe implicare qualche problema di performance

per il tuo sito web. Utilizzare con prudenza.

Installazione

------------

* Attivare il modulo.