Akismet 文档

How do I let Akismet know something is spam?

Akismet is always learning, so if you come across a piece of spam that Akismet misses, marking it as spam will help Akismet learn and not miss similar spam in the future.

Akismet has two levels of learning – global and local.

Local learning is taught by the site owner and occurs whenever something is marked as spam that Akismet thinks is not spam, and when something is marked as Not Spam and Akismet thinks it is. This helps Akismet learn what you like and don』t like. This is partly so spammers cannot try to 「poison」 Akismet so easily and also because some people get angry when any comments are caught – their blog, their comments.

Global learning is Akismet using all the input we get from site owners to learn what is actual spam and what is not.

How can I mark items as spam?

To mark an individual comment as spam, hover over it and press the 「Spam」 button.

If you have multiple comments you want to mark as spam, just check the boxes next to the comments you want marked as spam, select the 「Mark as Spam」 option from the bulk menu option at the top of the screen and press the 「Apply」 button.

I don』t think this is working!

If you continue to see things getting through that you』ve marked as spam, please reach out to Akismet Support with a few example comments and we』ll be happy to look into this further.

If you have more general questions about Akismet, please contact us here.

Five things every blogger should know about spam

1. Web spam is different from email spam.

Email spammers want you to buy their product. You are the target of the ad contained in each email spam you receive. Comment/web spammers want your readers to buy their product. You (the blogger, author, moderator) are not the target.

2. Web spammers are social engineers.

Email spammers write messages to get your attention. Comment spammers write messages to escape your attention. They want you to believe they are real bloggers, real people, writing real comments, so you』ll approve the comment and publish it on your site.

They use flattery, appeal to your good nature, and simply lie in order to convince you to give them the benefit of the doubt.

3. Web spammers are basically advertising on your blog…

…and they』re keeping all of the profits. They』re not even asking your permission first. Right now someone is offering to sell links from your blog to anyone willing to pay a few dollars (or a few cents). If your blog is well known, it may even be listed by name, with backlinks for sale at a set price.

4. It』s all about the backlinks.

Web spammers are selling links from your blog to their clients. They do this to game the search engines and trick your readers into visiting dubious web sites. Their clients are sometimes seemingly harmless, but are often peddling fake pills, porn, scams and malware.

Sometimes they』ll use 「buffer sites」 – that is, innocent looking web pages intended to disguise the fact that they』re really advertising something more sinister.

5. Spammers employ humans.

Not all spam is delivered by spambots. Spammers are increasingly using humans to write and post comments by hand. Typically they are exploiting low-paid workers in internet cafes, schools and factories.

Sometimes they are viral marketers paid to promote a new product. Either way they are trying to exploit your blog for their profit – and hoping to do it without you noticing.

What you can do about it.

Before you approve a comment, investigate the source of the comment. What things are they trying to link to or what site are they posting in their comment? Is the comment relevant to your post? Is it very generalized 「great post」 or 「glad I found your site」? If so, chances are those are spam comments and most likely Akismet will flag them for you.

But, spammers are always working to find new ways to get around our spam filtering. Akismet is always learning so if you come across a piece of spam that Akismet misses marking it as spam will help Akismet learn and not miss similar spam in the future.

If you have more general questions about Akismet, please contact us here.

How do I close comments on older posts?

We recommend closing comments on older posts on your blog. This guide explains how to do that for posts that have already been published, and posts that will be published in the future.

Closing comments on older posts that are already published

1. Go to Posts -> All Posts in your Dashboard:

2. Select all the posts you want to close comments on.

3. Select 「Edit」 from the 「Bulk Actions」 drop-down menu and click 「Apply」 to open the bulk editing screen:

4. Under the Comments drop-down menu select 「Do not allow」. Under Pings select 「Do not allow」 as well. Leave the rest of the options untouched and click 「Update」 to save those changes.

If you have many posts, you may need to repeat this process for the rest of your posts to turn off comments for all of your older posts.

What if I have a lot of posts to update?

You can change the number of posts that are displayed on each page to speed up this process. Here』s how to do that:

Click on the 「Screen Options」 tab at the top right of the screen and on the menu that shows up, change the number of posts to be displayed and click 「Apply」. We recommend setting this around 100 to avoid any site performance issues.

Closing comments on future posts automatically

You can automatically close comments on posts after they are published. Here』s how to do that:

Go to your Settings > Discussion page

Check the checkbox that says 「Automatically close comments on articles older than __ days」 under the Other comment settings section.

The default number is 14 days, but you can choose any number that best suits your site』s needs.

Then scroll down to the bottom of that page and click 「Save Changes」 to update that setting.

All done! After this option is checked comments will automatically close on all new published posts that are older than 14 days (or the number that you set).

If you have more general questions about Akismet, please contact us here.

How do I debug the Akismet plugin?

As of version 3.0.0, we have built debugging support into the Akismet plugin. This works with the debug system that is already in WordPress. Debug information is useful for identifying connection issues with the Akismet API that can prevent the plugin from working properly.

Between versions 3.0.0 and 3.3.3, Akismet will automatically log its debugging information if WP_DEBUG and WP_DEBUG_LOG are enabled. As of version 3.3.4, you must also enable AKISMET_DEBUG. In wp-config.php, add a line that looks like this:

1define( 'AKISMET_DEBUG', true );

Now the plugin will log debug information in the file /wp-content/debug.log

If your site is in production, it is a good idea to update your .htaccess file to deny access to this log file. You need to add this rule;

1234<Files ~ ".log$">;Order allow,denyDeny from all</Files>;

To turn off Akismet』s debugging, either remove this line:

1define( 'AKISMET_DEBUG', true );

or replace it with this line:

1define( 'AKISMET_DEBUG', false );

If you have more general questions about Akismet, please contact us here.

What if I forgot my API key?

If you forgot or cannot find your API key, you can get it resent to your email address here:

Resend

Just enter the email address you used to sign up for Akismet in the box, and click 「Continue」:

Your API key will be sent to you.

If you have more general questions about Akismet, please contact us here.

Why can』t Akismet connect to my server?

This page provides some technical information about Akismet for network administrators, server admins, and web hosts.

System requirements

Akismet is a spam filtering service. It』s most commonly used with WordPress, but is often used with other blog platforms, forum applications, contact forms and similar web apps. It』s a centralized service, so TCP connectivity to servers at Akismet.com is required for it to work.

System requirements for the WordPress plugin are the same as for WordPress, plus:

PHP』s fsockopen and gethostbynamel functions must not be disabled (they are enabled by default in PHP)TCP connectivity to akismet.com

Please see the next question for information about firewalls.

System requirements for other Akismet plugins and implementations vary, but TCP connectivity is always required.

Allowing Akismet to work with your firewall

In order for a blog or forum to use Akismet to check spam, it needs to be able to make outgoing TCP connections to servers at Akismet.com. If your network normally blocks outgoing connections from your public web servers, you』ll need to add a firewall rule permitting connections to Akismet.

If your security filters allow exceptions based on hostnames, you should permit connections on port 80 to:

rest.akismet.com
*.rest.akismet.com

Most Akismet API calls will be made to a host name of the form api_key.rest.akismet.com, where api_key is an alphanumeric string that is different for each web site owner.

If your security filters only allow IP-based rules, here are the current IP addresses used for Akismet API calls:

192.0.80.244192.0.80.246 192.0.96.247 192.0.96.248 192.0.123.250 195.234.111.251 195.234.111.252

All API calls are made on port 80 by default. If you are creating IP-based rules, it』s important that you allow connections to all of the listed IP addresses.

IMPORTANT: these IP addresses are current as of 2016-01-27, but are subject to change. If you are writing IP-based firewall rules, you』ll need to update those rules any time the addresses change. Please subscribe to this post』s RSS feed in order to receive notifications of any changes.

If you have any questions about this information or need further technical details, please contact Akismet support.

Auto-Activating and Configuring Akismet for WordPress (Standard and Multisite)

If you are running a WordPress Network (A.K.A WP Multisite), you might want to automatically activate, and configure, the Akismet plugin for every site powered by that MS instance.

Note: although the following is most commonly used in Multisite, the same code works just fine in standard WordPress.

Auto-Activating the Plugin

To do that, you can leverage WordPress Must Use Plugins (A.K.A. mu-plugins).

Here is an example mu-plugin that can live in wp-content/mu-plugins/akismet-loader.php:

123456789101112131415<?phpfunction wpms_akismet_loader() {        require_once( WP_PLUGIN_DIR . '/akismet/akismet.php' );} add_action( 'plugins_loaded', 'wpms_akismet_loader' ); function wpms_akismet_disable_plugin_actions( $actions, $plugin_file, $plugin_data, $context ) {        if ( 'akismet/akismet.php' === $plugin_file ) {                return array();        }        return $actions;} add_filter( 'plugin_action_links', 'wpms_akismet_disable_plugin_actions', 10, 4 );

The wpms_akismet_loader() function/action will load/enable the Akismet Plugin bundled with WP in wp-content/plugins/akismet/, without individual site administrators having to do so manually.

The wpms_akismet_disable_plugin_actions() function/filter will disable the actions normally found under a plugin』s name to avoid having your users enabling/disabling/editing/deleting the bundled Akismet plugin that you have auto-enabled in the previous step, leaving only the Settings link to configure Akismet.

Auto-Configuring the API Key

With only the above mu-plugin installed, each of the sites in the MS install would still have to configure Akismet with their own API key. This might be desirable, but you might also want to enable the same API key for all of the sites served by said instance.

To do so, you can leverage a special constant in the wp-config.php file that contains your WordPress install』s hardcoded settings: WPCOM_API_KEY. The constant starts with WPCOM_ because it was first used to configure such features on WordPress.com, the largest WP Multisite instance in the world.

Simply add the following anywhere in the wp-config.php file found at the root of your WP install, where 12345qwerty is the Akismet API key you want to be used everywhere:

12// AKISMET API KEYdefine('WPCOM_API_KEY','12345qwerty');

Note that once the constant is configured, the text field in the Akismet settings screen where one would normally enter the API key will no longer be displayed.

Akismet: Unblocking a spam

If a spam comment has been posted to your site you can mark it as spam simply by hovering your cursor over the comment and clicking the Spam link. 

If you』re using the Akismet plugin and you come across a spam comment that Akismet missed, marking it as spam will help Akismet learn and it will be less likely to miss similar spam in the future, as explained in Teach Akismet to identify spams.

Comments

If there are comments that have been marked as spam that shouldn』t be, click the checkboxes next to them and select Not Spam from the Bulk Actions drop-down at the top of the page. 

Click the Apply button to confirm your choice. 

Alternatively, click the Not Spam link that appears when hovering your cursor over each row.

Contact forms

Note that Akismet itself doesn』t have a tool to remove a contact from the spam list. The contact form you are using provides the tools to add or remove contacts from the spam list.

Your choices for contact forms are:

Jetpack

Jetpack Feedback has the same structure as WordPress comments. You just need to set the message as spam or not spam.

You can find more information about Jetpack Forms blocks here.

Gravity Forms

Gravity Forms has included built-in support for the Akismet Anti-Spam plugin since version 1.6. When the plugin is active you』ll find an Akismet setting located on the Forms > Settings page where you can disable or enable the integration; it is enabled by default for new installations.

When enabled all form submissions will be checked by Akismet. Submissions identified as spam by Akismet will have their entry status property set to spam preventing processing of notifications and add-ons.

Spam submissions can be reviewed in the Entries area of the form. Marking an entry as spam or not spam using the features available on the entries and entry detail pages will notify Akismet which will help train their filters.

Contact Form 7 + Flamingo

Flamingo provides you the integrated Akismet tool to remove an email from the spam list. More information at https://contactform7.com/spam-filtering-with-akismet/#reporting-false-detection

If you have more general questions about Akismet, please contact us here.