Gwolle GuestBook (Livre d’or)

Description

Gwolle Guestbook est le livre d’or WordPress que vous attendiez. Beau et simple.
Gwolle Guestbook n’est pas simplement un autre livre d’or pour WordPress. Le but est de proposer un moyen facile et léger pour installer un livre d’or dans votre site WordPress.
N’utilisez pas votre section ‘commentaires’ d’une mauvaise façon – installez Gwolle Guestbook et vous aurez un vrai livre d’or.

Les caractéristiques actuelles comprennent :

  • Un livre d’or public facile à utiliser avec un simple formulaire pour les visiteurs de votre site.
  • Une liste des messages du livre d’or côté public avec pagination ou défilement infini.
  • Un widget pour afficher un extrait de vos derniers ou meilleurs messages.
  • Une interface d’administration simple et propre qui s’intègre de façon transparente dans l’administration WordPress.
  • Un widget dans le Tableau de bord pour gérer facilement les derniers messages à partir de votre Tableau de bord d’administration.
  • Importation facile depuis d’autres livres d’or dans Gwolle Guestbook.
  • Notification par mail lorsqu’un nouveau message a été posté.
  • Modération, afin que vous puissiez vérifier un message avant qu’il ne soit visible dans votre livre d’or (facultatif).
  • 7 fonctionnalités anti-indésirables, comme Honeypot, Nonce, Formulaire Timeout, Akismet, Stop Forum Spam, et Questionnaire Quiz personnalisé.
  • Un constructeur de formulaires simple, pour sélectionner les champs du formulaire que vous voulez utilisez.
  • Simple constructeur d’entrée avec les parties de chaque entrée que vous souhaitez afficher.
  • Plusieurs livres d’or possibles
  • Supporte le MultiSites
  • Localisation. Les langues personnelles peuvent être ajoutées très facilement à travers GlotPress.
  • Les administrateurs peuvent ajouter une réponse à chaque message.
  • Un journal pour chaque message, de sorte que vous savez quel membre de l’équipe a publié et a édité un message du livre d’or public et quand.
  • Adresse IP et connexion-hôte avec lien vers le site de requête WHOIS.
  • Flux RSS.
  • Intégration de BBcode, Emoji et Smiley (facultatif).
  • Routine simple de désinstallation pour l’élimination complète de toutes les modifications de la base de données.

… et tout cela intégré dans l’apparence stylée de WordPress.

Import / export

Vous pouvez avoir un autre livre d’or installé. C’est génial, car Gwolle Guestbook vous permet d’importer facilement des messages.
L’importateur ne supprime aucune de vos données, afin que vous puissiez revenir à votre configuration précédente sans perte de données, si vous le voulez.
Essayer Gwolle Guestbook est aussi simple que 1-2-3.

L’importation est prise en charge à partir de :

  • DMSGuestbook.
  • Des commentaires WordPress à partir d’un article spécifique, d’une page ou tout simplement tous les commentaires.
  • Gwolle Guestbook lui-même, avec Export également pris en charge (fichier CSV).

Aide

Si vous avez un problème ou une demande spécifique, s’il vous plaît, postez-la dans le forum d’aide de l’extension sur wordpress.org. Je ferai de mon mieux pour répondre aussi vite que possible.

Si vous m’envoyez un email, je ne répondrai pas. Merci d’utiliser le forum d’aide.

Traductions

Translations can be added very easily through GlotPress.
You can start translating strings there for your locale. They need to be validated though, so if there’s no validator yet, and you want to apply for being validator (PTE), please post it on the support forum.
I will make a request on make/polyglots to have you added as validator for this plugin/locale.

Démo

Découvrez la démo sur http://demo.zenoweb.nl

Add-On

Gwolle Guestbook : le Add-On est un module pour Gwolle Guestbook qui apporte des fonctionnalités supplémentaires pour votre livre d’or.

Les caractéristiques actuelles comprennent :

  • Champ de données. Ajoutez le champ que vous voulez : entreprise, numéro de téléphone, c’est vous qui le nommez.
  • Partage social (facultatif)
  • Évaluation par étoiles, avec vote et affichage et Rich Snippets pour le SEO (facultatif)
  • Note moyenne du vote par étoiles pour le livre d’or
  • Prévisualisation pour le formulaire en frontend.
  • Prévisualisation pour le formulaire d’édition de l’administrateur.
  • Réponse de l’Administrateur sur l’interface publique avec AJAX.
  • Edit content of entry on the frontend with AJAX.
  • Report Abuse.
  • Blacklist for words and IP address.
  • Easy String Replacement in the default text so you can make this guestbook into a review section or anything you want.
  • Bouton de suppression sur chaque message pour le modérateur et l’auteur (facultatif).
  • Bouton permalien dans chaque message pour un accès facile (facultatif).
  • Bouton e-mail pour contacter chaque auteur (facultatif).
  • Sitemap support for popular SEO/Sitemap plugins.
  • Auto Anonymize timer (optional).
  • Auto Delete timer (optional).

You can buy the Add-On at Mojo Marketplace for only $ 9.

Demo with Add-On

Check out the demo with the Add-On enabled at http://demo.zenoweb.nl.

Compatibility

Cette extension est compatible avec ClassicPress.

Captures d’écran

  • Rendu visuel de la liste des messages du livre d’or. En haut, le bouton affichera le formulaire lorsqu'il sera cliqué. Puis la pagination. Puis la liste des messages.
  • Un widget avec différentes options.
  • Page d’administration principale, avec le panneau de vue d’ensemble, de sorte que vous pouvez voir facilement quel est l’état général.
  • Liste des messages du livre d’or. Les icônes indiquent l’état de chaque message.
  • L’outil d’édition d'un message unique. Les actions utilisent AJAX. Il y a un journal pour chaque message de ce qui se passe pour ce message.
  • Page de paramètres. Il s'agit du premier onglet dans lequel vous pouvez sélectionner les parties du formulaire à afficher et à utiliser.
  • Widget du tableau de bord avec les nouveaux messages et les messages non vérifiés.

Installation

Installation

  • Install the plugin through the admin page « Plugins ».
  • Alternatively, unpack and upload the contents of the zipfile to your ‘/wp-content/plugins/’ directory.
  • Activez l’extension par l’intermédiaire du menu « Extensions » de WordPress.
  • Placez ‘[gwolle_gb]’ dans une page. C’est tout.

As an alternative for the shortcode, you can use the function show_gwolle_gb(); to show the guestbook in your templates.
It couldn’t be easier.

Mise à jour à partir d’une ancienne version

With version 1.0 there have been some changes:

  • Gwolle Guestbook uses the Shortcode API now. Make sure your Guestbook page uses ‘[gwolle_gb]’ instead of the old one.
  • The entries that are visible to visitors have changed. Make sure to check if you have everything visible that you want and nothing more.
  • CSS has changed somewhat. If you have custom CSS, you want to check if it still applies.

Licence

The plugin itself is released under the GNU General Public License. A copy of this license can be found at the license homepage or
in the gwolle-gb.php file at the top.

Known Issues

On some websites sending the data from the form doesn’t work correctly. Some field data is being sent and some not.
If you are affected by this issue and can debug this to find the real problem, please do so and report it on the support forum.
Disabling AJAX for the form is a good workaround.

Points d’accroche : Actions et Filtres

Il existe de nombreux hooks disponibles dans ce plugin. La documentation est incluse dans le fichier zip dans /docs/actions et /docs/filters. Des exemples sont inclus. Si vous avez besoin d’un hook, veuillez le demander dans le forum d’assistance.

Ajouter un message avec du code PHP

It is not that hard to add an entry in PHP code.

<?php
    $entry = new gwolle_gb_entry();

    // Set the data in the instance, returns true
    $set_data = $entry->set_data( $args );

    // Save entry, returns the id of the entry
    $save = $entry->save();
?>

The Array $args can have the following key/values:

  • id, int with the id, leave empty for a new entry.
  • author_name, string with the name of the autor.
  • author_id, id with the WordPress user ID of the author.
  • author_email, string with the email address of the author.
  • author_origin, string with the city of origin of the author.
  • author_website, string with the website of the author.
  • author_ip, string with the ipaddress of the author.
  • author_host, string with the hostname of that ip.
  • content, string with content of the message.
  • datetime, timestamp of the entry.
  • ischecked, bool if it is checked by a moderator.
  • checkedby, int with the WordPress ID of that moderator.
  • istrash, bool if it is in trash or not.
  • isspam, bool if it is spam or not.
  • admin_reply, string with content of the admin reply message.
  • admin_reply_uid, id with the WordPress user ID of the author of the admin_reply.
  • book_id, int with the Book ID of that entry, default is 1.

Format for importing through CSV-file

The importer expects a certain format of the CSV-file. If you need to import from a custom solution, your CSV needs to conform.
The header needs to look like this:

<?php
array(
    'id',
    'author_name',
    'author_email',
    'author_origin',
    'author_website',
    'author_ip',
    'author_host',
    'content',
    'datetime',
    'isspam',
    'ischecked',
    'istrash',
    'admin_reply',
    'book_id',
    'meta_fields'
)
?>

The next lines are made up of the content.

There are some gotchas:

  • Date needs to be a UNIX timestamp. For manually creating a timestamp, look at the timestamp generator. When using a formatted date, the plugin will try to read it correctly. If it fails it will use today’s date.
  • Utilisez des virgules pour les séparateurs de champs. Si vous utilisez un logiciel Office comme Excel ou LibreOffice Calc, définissez-le correctement.
  • Utilisez des guillemets doubles (double quotes) autour de chaque champ. Quand aucun guillemets n’est utilisé, le processus d’importation peut casser lorsque vous disposez de citations ou de virgules dans le contenu du message.
  • Le fichier devrait encodé en UTF8-sans-BOM pour entrer correctement les caractères spéciaux.
  • Make sure you use UNIX line-endings. Any decent text-editor can transform a textdocument (CSV file) to UNIX line-endings.

With version 1.4.1 and older, the field datetime was called date.

You could make a test-entry, export that, and look to see what the importer expects from the CSV.
There is also an example CSV file included in the zipfile of the plugin under ‘/docs/import_example/’.

If you want to prepare a CSV file from other software, plaese be aware that Microsoft Excel is terrible in dealing with CSV files. You will not manage to create a working CSV file with this. Please use LibreOffice Calc for this.

FAQ

How do I get people to post messages in my guestbook?

You could start by writing the first entry yourself, and invite people to leave a message.

Quels messages sont visibles sur l’interface publique ?

Starting with version 1.0, the following entries are listed on the Frontend:

  • Coché
  • Not marked as Spam
  • Not in the Trash

Before that, in 0.9.7, all the ‘checked’ entries were visible.

I have a lot of unchecked entries. What do I do?
  • For the entries that you consider spam, but were not automatically marked as spam, you can manually mark them as spam, and they will not be visible anymore.
  • For entries that are not spam, but you still don’t want them visible, you can move them to trash.
  • The entries that you want visible, set them to checked.
Je veux traduire cette extension.

Les traductions peuvent être ajoutées très facilement grâce à GlotPress.
Vous pouvez commencer à traduire les chaînes là-bas pour votre langue.
Elles doivent être validées par ce biais, donc s’il n’y a pas encore de validateur, et que vous souhaitez postuler pour être validateur (PTE), veuillez le publier sur le forum support.
Je ferai une demande sur make/polyglots pour vous ajouter comme validateur de cette langue sur cette extension. (déjà fait en français).

What about Spam?

By default this plugin uses a Honeypot feature and a Nonce. If spambots try to post guestbook entries this should work sufficiently.

Si vous avez encore des problèmes, il y a plus d’options :

  • Honeypot feature: Hidden input field that only spambots would fill in.
  • Nonce: Will verify if you really loaded the page with the form first, before posting an entry. Spambots will just submit the form without having a Nonce.
  • Délai d’expiration du formulaire : si le formulaire est envoyé trop rapidement après le chargement de la page, le message sera marqué comme indésirable.
  • Akismet: Third party spamfilter by Automattic. Works really well, but not everybody likes to use a third party service.
  • Stop Forum Spam: Third party spamfilter. Again, works really well, but not everybody likes to use a third party service.
  • Custom Anti-Spam question: Use a simple quiz question to test if you are human.
I already use WP-SpamShield

WP-SpamShield is a general plugin for anti-spam that supports the general WordPress forms and many plugins.
Activating WP-SpamShield will disable the anti-spam features in Gwolle Guestbook and all anti-spam will be handled by WP-SpamShield.
If you don’t want to use WP-SpamShield’s protection for Gwolle Guestbook, then all you need to do is disable Anti-Spam for Miscellaneous Forms in WP-SpamShield settings.

How can I use Multiple Guestbooks?

You can add a parameter to the shortcode, like:

[gwolle_gb book_id="2"]

This will make that page show all the entries in Book ID 2.

If you use the template function, you can use it like this:

show_gwolle_gb( array('book_id'=>2) );
With multiple guestbooks, how do I keep track?

There is no need to use id’s that are incrementing.
If you have a lot of guestbooks on lots of pages, you can just use the id of the post as the id of the guestbook. That way you won’t have double id’s.
You can set the book_id automatically to the post_id with this shortcode:

[gwolle_gb book_id="post_id"]
I only want to show one entry.

You can use a shortcode parameter for showing just one entry:

[gwolle_gb_read entry_id="213"]
I don’t see the labels in the form.

This plugin doesn’t apply any CSS to the label elements. It is possible that your label elements have a white color on a white background.
You can check this with the Inspector in your browser. If that is the case, you have a theme or plugin that is applying that CSS to your
label elements. Please contact them.

I don’t get a notification email.

First check your spambox in your mailaccount.

Second, on the settingspage you can change the From address for the email that is sent.
Sometimes there are problems sending it from the default address, so this is a good thing to change to a real address.

Il y a également plusieurs plugins SMTP, où vous pouvez configurer beaucoup de paramètres pour le courrier électronique.

If it still doesn’t work, request the maillog at your hosting provider, or ask if they can take a look.

I want to show the form and the list on different pages

There are different shortcodes that you can use.
Instead of the ‘[gwolle_gb]’ shortcode, you can use ‘[gwolle_gb_write]’ for just the form, and ‘[gwolle_gb_read]’ for the list of entries.

Il y a aussi un widget qui peut afficher les derniers messages dans une zone de widget, avec de nombreuses options. Vous pouvez également utiliser le code court ‘[gwolle_gb_widget]’ pour afficher les derniers messages selon la mise en page du widget. Les paramètres sont :

  • book_id, int with an ID.
  • num_entries, int with the shown number of messages.
  • num_words, int with the shown number of words per entry.
I want to show the form immediately, without the button

The shortcodes ‘[gwolle_gb]’ and ‘[gwolle_gb_write]’ have a parameter for the button.
You can use them as ‘[gwolle_gb button= »false »]’ or ‘[gwolle_gb_write button= »true »]’, to deviate from the default.

Moderation is enabled, but my entry is marked as checked

If a user with capability of ‘moderate_comments’ posts an entry, it will be marked as checked by default, because he can mark it as checked anyway.

Moderation is disabled, but some entries are still unchecked

There is validation of the length of words in the content and author name.
If the words are too long and it looks abusive, it will be marked as unchecked. A moderator will still be needed to manually edit and check these entries.

On the form I see text meant for screen-readers.

Your theme is missing some necessary CSS for ‘.screen-reader-text’. Please contact the maker of your theme.
More information can be found in the Handbook about Accessibility.

When opening the RSS Feed, I get a Error 404

You can refresh your rewrite rules, by going to Settings / Permalinks, and save your permalinks again.
This will most likely add the rewrite rule for the RSS Feed.

I use a caching plugin, and my entries are not visible after posting

When you have moderation disabled, Gwolle Guestbook will try to refresh the cache.
If it doesn’t on your setup, please let me know which caching plugin you use, and support for it might be added.

You can also refresh or delete your cache manually. Most caching plugins offer support for that.

I use a Multi-Lingual plugin

There are 2 settings that you need to pay attention to. If you saved the settings for the form tab, you should save an
empty header and notice text. It will fill in the default there after saving, but that is okay.
As long as you saved an empty option, or it is still not-saved, then it will show the translated text from your MO file.

Also, you will want to use the book_id parameter of the shortcode for multiple guestbook.

J’utilise un thème avec AJAX

L’utilisation d’un thème avec la navigation AJAX peut poser des problèmes. Le JavaScript et le CSS sont chargés seulement sur la page du livre d’or. Ainsi vous devriez le charger sur chaque page pour l’avoir disponible pour le livre d’or. Vous pouvez ajouter le code suivant au fichier functions.php de votre thème :

<?php
function my_gwolle_gb_register() {
    wp_enqueue_script('gwolle_gb_frontend_js');
    wp_enqueue_style('gwolle_gb_frontend_css');
}
add_action('wp_enqueue_scripts', 'my_gwolle_gb_register', 20);
?>

I don’t have any experience myself with AJAX themes. If it doesn’t work, please contact the theme author.

J’utilise l’extension Autoptimize

The frontend scripts will only be loaded on the Guestbook page, so they won’t be added to autoptimize.
You can add ‘gwolle_gb_frontend’ to both the comma-separated JS and CSS autoptimization exclusion list. That way it will still be loaded right.
On the autoptimize settings page, you might have to click on « show advanced settings »-button top-right first. More info on troubleshooting in AO’s FAQ.

What capabilities are needed?

For moderating comments you need the capability ‘moderate_comments’.

For managing options you need the capability ‘manage_options’.

Can I override a template?

You can look at ‘frontend/gwolle_gb-entry.php’, and copy it to your theme folder. Then it will be loaded by the plugin.
Make sure you keep track of changes in the default templatefile though. It is often better to use filters, that way you are more forward-compatible.

Quels crochets sont disponibles pour la personnalisation ?

Il existe de nombreux points d’accroche disponibles dans cette extension. La documentation est incluse dans le dossier zip dans /docs/actions et /docs/filters. Des exemples sont inclus.
Si vous avez besoin d’un crochet supplémentaire, veuillez le demander dans le forum support.

Je veux changer les mots Livre d’or en quelque chose d’autre.

Tout d’abord, cette extension sert pour un livre d’or. Si vous voulez l’utiliser pour un usage différent, vous devrez faire ceci dans le code.
Jetez un coup d’oeil à la question précédente relative aux hooks.
Vous allez probablement vouloir utiliser les hooks pour ‘gwolle_gb_write’ et ‘gwolle_gb_button’.

This question gets asked a lot. You can also take a look at the support forum. Also, the add-on has options for text changes.

I have a one-page design and want to use links with the right anchor.

It should be possible by using a filter.
Have a look at this example code. Make sure to use the correct anchor tag for your website.

Should I really not use WordPress comments for a guestbook?

Sure you can if you want to. In my personal opinion however it can be a good thing to keep comments and guestbook entries separated.
So if you already have a blog with comments, the guestbook entries might get lost in there, and keeping a separate guestbook can be good.
But if you don’t use standard comments, you can just as easily use the comment section for a guestbook.

Avis

6 novembre 2019
I have been using this plugin for some time now and find it to be a great addition to my website. It's very easy to customize and truly works like a charm. Since I was really happy with it, I bought the Add-On to add even more features and change a bit its purpose (it's a very versatile plugin, so it can be used in a variety of ways) and I honestly couldn't be happier with the result. I've contacted the author a couple of times on this forum to ask for information and he provided me with quick answers and amazing support. Don't think twice about choosing this plugin if you are interested in its features, and if you enjoy how it works but want a little more customization go ahead with the purchase of The Add-On: it is really inexpensive and does wonders!
26 octobre 2019
Hi, Thanks for your plugin, is really usefull I want to know if is it possible to change font in function of comment. I see that's possible between pair and odd. but's is it possible by number of comment ? all #2 all #3 ? Thanks a lot Eric
19 octobre 2019
Лично мне плагин очень понравился, автор молодец!!!
1 juillet 2019
Al lang een zeer tevreden gebruiker van het Gastenboek. Tot zich, na instellen van een nieuw thema, problemen voordeden. Er was geen zichtbare knop om een nieuw bericht aan te maken en boven ieder bericht verscheen een uitgerekt en opgeblazen avatar. Ondanks de hitte van vandaag is Marcel dan toch zeer snel hulpvaardig en geeft duidelijk aan hoe het probleem is op te lossen. Marcel, hartelijk dank.
Lire les 81 avis

Contributeurs & développeurs

« Gwolle GuestBook (Livre d’or) » est un logiciel libre. Les personnes suivantes ont contribué à cette extension.

Contributeurs

“Gwolle GuestBook (Livre d’or)” a été traduit dans 14 locales. Remerciez l’équipe de traduction pour ses contributions.

Traduisez « Gwolle GuestBook (Livre d’or) » dans votre langue.

Le développement vous intéresse ?

Parcourir le code, consulter le SVN dépôt, ou s’inscrire au journal de développement par RSS.

Journal

3.1.7

  • 2019-10-25
  • Show subscription status for email notifications on settings page.
  • Comment out unused images in markitup CSS.
  • Set rel=’nofollow noopener noreferrer’ for bbcode links and user website.
  • Set referrerpolicy=’no-referrer’ for bbcode images and avatar.
  • Add filter ‘gwolle_gb_bbcode_img_referrer’.
  • Update strings for add-on.

3.1.6

  • 2019-08-21
  • Use wp_kses for filtering html elements.
  • Add support for quotes already in the bbcode link.

3.1.5

  • 2019-06-08
  • Add log entry for privacy policy accepted (gets added to notification mail).
  • Add msg_txt key/value to log entries for plain text display.
  • Small updates to install routine.
  • Support new wp_initialize_site action for multisite.

3.1.4

  • 2019-05-03
  • Make it possible to set entry to moderated with the gwolle_gb_new_entry_frontend filter.
  • Update strings for add-on.

3.1.3

  • 2019-04-16
  • Small fix for silly mistake.

3.1.2

  • 2019-04-04
  • Improve accessibility for the frontend metabox.
  • Add filter gwolle_gb_new_entry_frontend.
  • Add filter gwolle_gb_get_permalink.
  • Change arrows in next/prev pagination.
  • Auto-detect line endings in import from CSV.

3.1.1

  • 2019-03-08
  • Drop check for mime-type on import, too many problems.
  • Small CSS fix for pagination.

3.1.0

  • 2019-02-19
  • Remove support for Really Simple Captcha plugin, since it is ineffective.
  • Please take a look at the other options for spamfilters, there are more and better options.
  • Update CSS for admin navigation for WP 5.1.
  • Add screen-reader-text to navigation for frontend and admin.
  • Small fixes found by the phan tool.

3.0.0

  • 2019-01-22
  • Add search widget (only visible on guestbook pages).
  • Add ‘[noscript]’ to frontend form for when JavaScript is disabled.
  • Add function ‘gwolle_gb_post_is_guestbook’.
  • Add function ‘gwolle_gb_get_entries_from_search’.
  • Add function ‘gwolle_gb_enqueue_markitup’.
  • Fix BBcode: support images inside links.
  • Fix BBcode: have sublists work.
  • Show new username and book ID after editing in editor postbox.
  • Add some accessibility fixes.
  • Switch database engine to InnoDB.
  • Don’t use transients for hashed field names, is faster this way.
  • Better test if admin user exists for admin_reply.
  • Use ‘field-name’ for gwolle_gb_content too.
  • On admin pages, have separate functions for $_POST update. (settings, editor, entries).
  • Use GWOLLE_GB_URL where appropriate.
  • Use static vars instead of global vars.
  • Integrate 2 JavaScript files for Markitup/BBcode.
  • Switch export to 2000 entries per part instead of 3000.
  • Ajout de chaînes pour le module 1.3.0.
  • Cleanup changelog. Add changelog-v2.txt.