Title: Spots
Author: interconnectit
Published: September 28, 2011
Last modified: September 29, 2022
---
Search plugins
This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.
# Spots
By [interconnectit](https://profiles.wordpress.org/interconnectit/)
[Download](https://downloads.wordpress.org/plugin/spots.1.3.10.zip)
* [Details](https://pcd.wordpress.org/plugins/spots/#description)
* [Reviews](https://pcd.wordpress.org/plugins/spots/#reviews)
* [Installation](https://pcd.wordpress.org/plugins/spots/#installation)
* [Development](https://pcd.wordpress.org/plugins/spots/#developers)
[Support](https://wordpress.org/support/plugin/spots/)
## Description
Here at interconnect/it we have a policy of developing client sites with the premise
of “content manage everything!” That means the little notices on sites, minor widgets
and so on should not only be content managed, but they should be easy for both an
end-user and a developer to work with.
To that end, we developed Spots. This creates a custom post type that allows you
to create widgets using a visual editor, whilst also giving developers an easy hook
for the creation of content managable elements within a theme.
The plugin now uses caching in order to help ensure that the load on a typical site
is kept to a minimum. Performance is important!
The plugin is prepared for translation, if you’d like to drop us a line about your
translation you can contact us through our [website](http://interconnectit.com/about/contact/).
### Developer Notes
Spots provides 2 template tags for developers to use shown below with their supported
arguments.
```
icit_spot( $id_or_name, $template );
```
* `$id_or_name`: Required. A numeric ID or the name of a spot as a string.
* `$template`: Optional. A string used in a call to `get_template_part()`
This template tag always echos out the spot.
```
icit_get_spot( $id_or_name, $template, $echo );
```
Same as the above with an extra argument:
* `$echo`: Optional. Defaults to false. A boolean to indicate whether to echo the
spot content or just return it.
#### Basic Usage
You can use spots to replace boilerplate text in your themes. If you have areas
in your themes where typically you would hard code the text you could use the following
code:
```
```
The above code would output the contents of a spot titled ‘Copyright’. If the spot
does not exist it will be created as a draft. Spots in draft mode are only visible
to logged in users with editing capabilities.
#### Templates
The plugin will initially look for a file in your theme using the `get_template_part()`
function. If you have a file called `spot.php` in your theme that will be the default
template for all spots. The `icit_spot()` function can take a second parameter for
the template part to use for example:
```
```
The above code will make the plugin look in your theme folder for a file called `
spot-copyright.php` to use for the output. If not available it will fall back to`
spot.php` and if that is not available it will simply output the spot contents.
Use templates when you want to display a featured image from a spot or if you require
some additional/alternative markup for the spot. Spots are just like posts, so in
the templates you retrieve the contents of the spot using `the_content()` just as
would in the loop.
**Basic spot template example:**
```
```
**Spot template with featured image:**
```
```
#### Additional
There are many filters and hooks available to get even more out of spots so drop
by the plugin homepage or use the forums if there is something you need to do with
spots but aren’t sure how.
## Screenshots
* [[
* Spots widget when you first use it
* [[
* The Spots custom post type in action
* [[
* Selecting a pre-existing Spot
* [[
* The visual editor in Spots
* [[
* A Spot output in a sidebar as a widget
* [[
* A Template Tag replacement of content in the footer of the 2010 theme.
## Installation
#### The install
1. You can install the plugin using the auto-install tool from the WordPress back-
end.
2. To manually install, upload the folder `/spots/` to `/wp-content/plugins/` directory.
3. Activate the plugin through the ‘Plugins’ menu in WordPress
4. You should now see the Spots widget show up under ‘widgets’ menu. Drop that widget
into a sidebar and you can immediately create Spots.
5. You should also now see a new post type appear called Spots in your WordPress back-
end. You can create Spots here for use later or in development.
#### Using the plugin
1. Once the plugin is activated, you will see a new widget appear titled Spots.
2. Drop the widget into an appropriate widget space.
3. If you haven’t already created a new Spot, you can do so directly from the widget,
using the visual editor.
4. If you have already created a Spot you can opt to use this from the drop down.
5. You can edit Spots just like Posts or Pages – you’ll see Spots just below the Comments
menu.
6. Spots are also available as a shortcode. Click the icon in the rich text editor
on posts or pages and search for the spot you want to insert.
## FAQ
### When I edit a spot template I don’t see the change
Spots has a built in caching system, a popular request when we first launched the
plugin. This creates a problem when you edit the template files that spots use as
we can’t detect changes without creating a database query.
Place the following code in your functions.php to turn off the cache:
```
define( 'SPOTS_CACHE_TIME', 0 );
```
_NOTE:_ We only recommend doing this for your development environment however if
your spots are dynamic or you use a site-wide caching plugin then leave the above
definition in.
### Can I use Spots to replace the clunky old Text Widget?
Yes indeed – in fact that was the first inspiration behind creating Spots – we felt
the text widget was only suitable for use by people who knew HTML well. Spots gives
you a visual editor, making this much easier to use.
### Can I use Spots anywhere in my theme?
You can, if your theme either has built-in support for Spots, or you’ve added the
appropriate template tags.
### What happens if I put an image in a Spot?
The image will be used as you’ve input it – bear in mind that in certain locations
this may not work well, or your theme may not have appropriate styling in place.
In most cases it will work just fine, but do be careful not to insert images larger
than the space you have available.
### How does the featured image work?
If you have a featured image, your theme can use this for display options. If your
theme does not fully support Spots then featured images will have no effect and
only the main content of the Spot will be displayed. See the developer notes for
more information on adding templates to a theme to get the most out of spots.
## Reviews
### [Default install on every site](https://wordpress.org/support/topic/default-install-on-every-site/)
[Radices](https://profiles.wordpress.org/radices/) September 3, 2016
Awesome plugin!
[ Read all 10 reviews ](https://wordpress.org/support/plugin/spots/reviews/)
## Contributors & Developers
“Spots” is open source software. The following people have contributed to this plugin.
Contributors
* [ interconnectit ](https://profiles.wordpress.org/interconnectit/)
* [ Spectacula ](https://profiles.wordpress.org/spectacula/)
* [ cm2creative ](https://profiles.wordpress.org/cm2creative/)
[Translate “Spots” into your language.](https://translate.wordpress.org/projects/wp-plugins/spots)
### Interested in development?
[Browse the code](https://plugins.trac.wordpress.org/browser/spots/), check out
the [SVN repository](https://plugins.svn.wordpress.org/spots/), or subscribe to
the [development log](https://plugins.trac.wordpress.org/log/spots/) by [RSS](https://plugins.trac.wordpress.org/log/spots/?limit=100&mode=stop_on_copy&format=rss).
## Changelog
#### 1.3.9
* Updated “tested up to” value
#### 1.3.8
* Fixed: Fix widget media button
#### 1.3.7
* Fixed: “Insert spot” menu not working.
#### 1.3.6
* Fixed: Double icon effect
#### 1.3.5
* Fixed: Fatal error on versions < 4.3 with new function format_for_editor()
#### 1.3.4
* Fixed: Widgets not working in 4.3
* Fixed: Notices about deprecated functions
#### 1.3.3
* Fixed: More fixes for WordPress 4.0.1 and the quote problem.
* Fixed: WordPress 4.0+ sending media to a tinyMCE in a widget would fail silently.
* Fixed: Few other fixes and tweaks.
#### 1.3.2
* Fixed: WordPress as of 4.0.1 makes the assumption that quotes after a number
are always to denote feet/inches, this messes up the very late running of our
shortcode. I’ve implemented a fix that’ll repair the quotes around the post_id
in the shortcode.
#### 1.3.1
* Fixed: Issue with admin https and the front end http.
#### 1.3
* Added: Filter to disable the edit spot button. Adding add_filter( ‘spots_show_edit_link’,‘
__return_false’ ); to your functions.php should result in the removal of the
inline edit link.
* Fixed: Media button no more in line with WordPress best practice.
* Added: Toggles to the widget admin that’ll let you edit raw text. The HTML button
was removed from WP 3.9 and rather than add it back in I thought it bettet to
use something similar to the tabs on the normal post edit page.
#### 1.2.2
* Fixed: Titles can be blank again. Oops!
* Fixed: Widget drag handles can be clicked to open the widget and show TinyMCE.
#### 1.2.1
* Fix the missing media buttons on the widget interface.
#### 1.2
* Added: Support for the new tinyMCE in WordPress 3.9
* Fixed: TinyMCE button on the post edit page.
* Fixed: TinyMCE is working in the widget again.
* Fixed: Bug with the showing of tinyMCE if you toggle the widget show/hide quickly.
* Fixed: Removed some strict warnings with PHP 5.5.
#### 1.1.8
* Fixed: Edit capability not checking the specific spot in 1 circumstance
* Fixed: Spot auto creation when used in templates now also searches for the post
name, preventing duplication on title changes
#### 1.1.7
* Fixed: edit links being cached in certain suituations
#### 1.1.6
* Fixed: late run shortcodes in content not being run through shortcode_unautop()
#### 1.1.5
* Modified: ‘Edit spot’ link styling like an admin button and appears within spot
area incase of `overflow:hidden;`.
* Added: ‘Edit spot’ link also appears on spots referenced directly in template
#### 1.1.4
* Fixed: Compatibility issue with various plugins that modify the content after
do_shortcode has run – thanks to @NickToye for spotting it
* Removed: Ability to view featured image in widget screen in WP 3.5 or above.
You can still set it in the full editor and in the add media popup
* Fixed: Empty paragraph was being inserted when moving a widget around
* Added: Spots no longer cached if current logged in user can edit them
#### 1.1.3
* Fixed: Spot edit buttons on the frontend would appear underneath other items
making them unclickable
* Fixed: The spots menu icon under iOS and other high density displays now display
correctly
* Modified: Edit buttons are now labeled “Edit Spots” rather than just Edit
* Added: Shortcodes in content now have the same edit buttons on hover that widgets
have
#### 1.1.2
* Fixed: CSS rules weren’t a high enough priority in some themes, increase the
specificity of the colours so they’re not overridden
* Added: New setting, lets you choose if search engines will index individual spots,
set to no by default, prevents individual spots showing up in search listings
ahead of the pages they’re intended to appear on
#### 1.1.1
* Added: Logged in users able to edit spots can now see an edit link when hovering
over a spot on the frontend
* Fixed: The edit link on the spots widget edit form now has a target of _parent
#### 1.1.0
* Fixed: The new theme template API implementation actually works now! Sorry folks
#### 1.0.9
* Added a basic options page to control the caching
* Fixed: Now uses new theme API to find templates in WordPress 3.4+
#### 1.0.8
* Fixed: A small bug meant that permalinks were being flushed and recreated on
every page load
#### 1.0.7
* Added: Allow WordPress to do the serialisation for the transients. Was causing
problems after BackupBuddy plugin was used.
* Fixed: Caching was happening even when cache time was set to 0, removed an unnecessary
db query.
* Fixed: Caching was happeninig in admin which would cause GravityForms to render
as the editable form
* Added: Improved styling of widget for latest WP versions
* Fixed: URL escaped ampersand in post type edit link
#### 1.0.6
* Added: Smart default for widget title when selecting a spot
* Added: Advice on disabling the spots cache to readme.txt
#### 1.0.5
* Added: Added support for revisions to the spots post type, idea from Doug Smith(
http://smithsrus.com/).
#### 1.0.4
* Fixed: `spot_post_exists()` to only check the spots post type to avoid displaying
other content of the same name.
* Added: Made the currently selected spot more obvious when in the spot selector
MCE popup.
* Fixed: TinyMCE with WordPress 3.3 would leave an editor at the bottom of the
widget page.
* Fixed: TinyMCE would not tolerate other tinyMCE widget instances.
* Fixed: TinyMCE would break on drag and drop of a widget.
* Fixed: Set spot thumbnail always available even when there was no theme support
for post-thumbnails.
* Fixed: Now respects your Visual editor profile settings.
* Fixed: Bug with caching system meant cache didn’t flush on widget edit pages.
#### 1.0.3
* Fixed: Featured image was not being correctly displayed as it relies on the $
post global being overridden.
#### 1.0.2
* Fixed: Bug with media upload buttons not associating the spot with its attachments
on the widgets screen.
#### 1.0.1
* Improved UI and UX on widget.
* Fixed bug that created multiple draft versions of a Spot when a template tag
initiated a non-existent Spot.
* Fixed WP 3.3 missing toolbar issue in widget visual editor.
#### 1.0.0
* Development version and Alpha release.
## Meta
* Version **1.3.10**
* Last updated **4 years ago**
* Active installations **900+**
* WordPress version ** 4.0 or higher **
* Tested up to **6.0.11**
* Language
* [English (US)](https://wordpress.org/plugins/spots/)
* Tags
* [content management](https://pcd.wordpress.org/plugins/tags/content-management/)
[elements](https://pcd.wordpress.org/plugins/tags/elements/)[spots](https://pcd.wordpress.org/plugins/tags/spots/)
[widget](https://pcd.wordpress.org/plugins/tags/widget/)
* [Advanced View](https://pcd.wordpress.org/plugins/spots/advanced/)
## Ratings
5 out of 5 stars.
* [ 10 5-star reviews ](https://wordpress.org/support/plugin/spots/reviews/?filter=5)
* [ 0 4-star reviews ](https://wordpress.org/support/plugin/spots/reviews/?filter=4)
* [ 0 3-star reviews ](https://wordpress.org/support/plugin/spots/reviews/?filter=3)
* [ 0 2-star reviews ](https://wordpress.org/support/plugin/spots/reviews/?filter=2)
* [ 0 1-star reviews ](https://wordpress.org/support/plugin/spots/reviews/?filter=1)
[Add my review](https://wordpress.org/support/plugin/spots/reviews/#new-post)
[See all reviews](https://wordpress.org/support/plugin/spots/reviews/)
## Contributors
* [ interconnectit ](https://profiles.wordpress.org/interconnectit/)
* [ Spectacula ](https://profiles.wordpress.org/spectacula/)
* [ cm2creative ](https://profiles.wordpress.org/cm2creative/)
## Support
Got something to say? Need help?
[View support forum](https://wordpress.org/support/plugin/spots/)
## Donate
Would you like to support the advancement of this plugin?
[ Donate to this plugin ](http://interconnectit.com/2364/announcing-spots/)