This plugin was developed to allow canonical tags as response headers to be created via htaccess for attachment files such as pdfs and docs.
This plugin was developed to allow canonical tags as response headers to be created via htaccess for attachment files such as pdfs and docs.
The plugin:
The challenge: Analytics software such as Google Analytics, cannot track a user that enters a website via a pdf file in Google search results. Files cannot have a standard canonical tag added in the <head> and instead the canonical tag has to be added via an http header when the file is requested from the server. In order to accomplish this, we need to have an htaccess file listening for a request to that file, and then sending the header.
Expected outcome: PDF files and other attachments will be replaced in search results with the post or page counterparts, and we will be able to measure the traffic to those pages and provide calls to action for downloading the file, submitting contact forms, etc. Note: Canonical tags do not force a search engine to index one url vs. another, but act as a guideline/request to the search engine. As long as the attachment content is similar to the canonical URL, you should have no problem encouraging the search engines to choose the correct version.
Based on the feedback, we hope to continue developing additional features to support user requests. Current future feature ideas include:
This section describes how to install the plugin and get it working.
canonical-attachements.zip
to the /wp-content/plugins/
directoryPlugin dashboard with options for bulk editing or individual editing to create canonicals for attachment files, and easy filters to drill down to those files needing fixed!
Main page with options explained / highlighted
Editor page for the uploads .htaccess file
Media pages have an input field for the canonical URL
Option to enter canonical url when you upload a file
No. This plugin only works for wordpress installations on servers running apache, as it is depending on writing the rules to the .htaccess file.
The plugin will need to be able to write to the directory in order to work. When you install the plugin, it will create the .htaccess file with the proper permissions.
As there may be other items in the htaccess file that are important, uninstalling this plugin does not remove the .htaccess file. You will have to do this manually. It is important to note that uninstalling this plugin does not remove any content of the htaccess file. If you wish to remove canonicals, you should use the bulk editor or manually edit the .htaccess file using the editor option. When you remove by manually editing the htaccess file, the associations will still exist in the wordpress database as an option for that media item, but since they are not in the .htaccess file, they will be “useless”. This is why it is recommended to use the bulk editor vs. editing htaccess directly.
In some instances there may be files outside of wordpress’s database that you wish to canonical, so we wanted to make it accessible for adding those items. The most likely case for this would be if you migrated to wordpress and manually moved a directory or files into the uploads folder vs. uplaoding through wordpress. Future iterations of this plugin might include a way to better manage non wordpress linked media files.
This has nothing to do with our plugin, but occurs when you upload media files when you are not editing / creating a post. The wordpress library has a filter for unattached media items, and you can attach them manually there. Our editor does not require the media item be attached to a post, it just makes it possible to use the bulk feature to attach vs. having to do it one at a time. You can also use the post finder from the “attach media” option in our bulk editor.
This plugin was developed by the good folks at Hive Digital