WordPress.org

Ready to get started?Download WordPress

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

it:Riferimento funzioni/check comment

This article is marked as in need of editing. You can help Codex by editing it.

Descrizione

check_comment() controlla se un commento supera le verifiche interne impostate dalla moderazione dei commenti di WordPress .

Utilizzo

<?php
   check_comment
$author$email$url$comment$user_ip,
         
$user_agent$comment_type );
?>

Parametri

$author
(string) (richiesto) Nome dell'autore del commento.
Default: Nessuno
$email
(string) (richiesto) E-mail dell'autore del commento.
Default: Nessuno
$url
(string) (richiesto) URL dell'autore del commento.
Default: Nessuno
$comment
(string) (richiesto) Contenuto del commento.
Default: Nessuno
$user_ip
(string) (richiesto) Indirizzo IP dell'autore del commento.
Default: Nessuno
$user_agent
(string) (richiesto) User agent dell'autore del commento.
Default: Nessuno
$comment_type
(string) (richiesto) Tipo di commento: (comment, trackback o pingback).
Default: Nessuno

Valori restituiti

(boolean) 
Questa funzione restituisce un valore booleano.

Restituisce false se nella moderazione dei commenti:

  • l'amministratore deve approvare tutti i messaggi,
  • il numero di link esterni è troppo alto, oppure
  • si rileva una parola, un nome, un URL, un'e-mail o un IP vietati in uno qualunque dei parametri ad eccezione di $comment_type.

Restituisce true se l'amministratore non deve approvare tutti i messaggi e:

  • il parametro $comment_type è un trackback o pingback e parte del blogroll, oppure
  • i parametri $author e $email sono già stati approvati.

Restituisce true in tutti gli altri casi.

Esempi

Semplice caso d'uso

 <?php 
 $author = "John Charles Smith";
 $email = "jsmith@example.com";
 $url = "http://example.com";
 $comment = "Eccellente...";
 $user_ip = "12.34.56.78";
 $user_agent = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_6_8) AppleWebKit/535.11 (KHTML, like Gecko) Chrome/17.0.963.79 Safari/535.11";
 $comment_type = "comment";
 if (check_comment( $author, $email, $url, $comment, $user_ip, $user_agent, $comment_type )) {
   echo "Il robot dei commenti dice: Grazie per il tuo commento.";
 } else {
   echo "Il robot dei commenti dice: Questo commento NON è valido!";
 } 
?>

Note

Log delle modifiche

  • Da: WordPress Version 1.2

File sorgente

check_comment() si trova in wp-includes/comment.php.

Correlati

Si veda anche l'indice di Riferimento funzioni e l'indice di Tag dei template.