Title: Spots
Author: interconnectit
Published: <strong>2011 年 9 月 28 日</strong>
Last modified: 2022 年 9 月 29 日

---

搜尋外掛

![](https://ps.w.org/spots/assets/banner-772x250.jpg?rev=647503)

這個外掛**並未在最新的 3 個 WordPress 主要版本上進行測試**。開發者可能不再對這個
外掛進行維護或提供技術支援，並可能會與更新版本的 WordPress 產生使用上的相容性問題。

![](https://ps.w.org/spots/assets/icon-256x256.png?rev=1025761)

# Spots

 由 [interconnectit](https://profiles.wordpress.org/interconnectit/) 開發

[下載](https://downloads.wordpress.org/plugin/spots.1.3.10.zip)

 * [詳細資料](https://tw.wordpress.org/plugins/spots/#description)
 * [使用者評論](https://tw.wordpress.org/plugins/spots/#reviews)
 *  [安裝方式](https://tw.wordpress.org/plugins/spots/#installation)
 * [開發資訊](https://tw.wordpress.org/plugins/spots/#developers)

 [技術支援](https://wordpress.org/support/plugin/spots/)

## 外掛說明

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:

    ```
    <?php
    if ( function_exists( 'icit_spot' ) )
        icit_spot( 'Copyright' );
    ?>
    ```

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:

    ```
    <?php
    if ( function_exists( 'icit_spot' ) )
        icit_spot( 'Copyright', 'copyright' );
    ?>
    ```

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:**

    ```
    <div class="spot">
        <?php the_content(); ?>
    </div>
    ```

**Spot template with featured image:**

    ```
    <div class="spot-with-image">
        <?php
            if ( has_post_thumbnail() )
                the_post_thumbnail( 'medium' );
            the_content(); ?>
    </div>
    ```

#### 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.

## 螢幕擷圖

 * [[
 * 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.

## 安裝方式

#### 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.

## 常見問題集

### 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.

## 使用者評論

![](https://secure.gravatar.com/avatar/5a5afe72170f4bc36482205c38f357708cba9f38afdef81e12c037e78ea5e993?
s=60&d=retro&r=g)

### 󠀁[Default install on every site](https://wordpress.org/support/topic/default-install-on-every-site/)󠁿

 [Radices](https://profiles.wordpress.org/radices/) 2016 年 9 月 3 日

Awesome plugin!

 [ 閱讀全部 10 則使用者評論 ](https://wordpress.org/support/plugin/spots/reviews/)

## 參與者及開發者

以下人員參與了開源軟體〈Spots〉的開發相關工作。

參與者

 *   [ interconnectit ](https://profiles.wordpress.org/interconnectit/)
 *   [ Spectacula ](https://profiles.wordpress.org/spectacula/)
 *   [ cm2creative ](https://profiles.wordpress.org/cm2creative/)

[將〈Spots〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/spots)

### 對開發相關資訊感興趣？

任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/spots/)、查看 
[SVN 存放庫](https://plugins.svn.wordpress.org/spots/)，或透過 [RSS](https://plugins.trac.wordpress.org/log/spots/?limit=100&mode=stop_on_copy&format=rss)
訂閱[開發記錄](https://plugins.trac.wordpress.org/log/spots/)。

## 變更記錄

#### 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.

## 中繼資料

 *  版本 **1.3.10**
 *  最後更新 **4 年前**
 *  啟用安裝數 **900+**
 *  WordPress 版本需求 ** 4.0 或更新版本 **
 *  已測試相容的 WordPress 版本 **6.0.11**
 *  語言
 * [English (US)](https://wordpress.org/plugins/spots/)
 * 標籤:
 * [content management](https://tw.wordpress.org/plugins/tags/content-management/)
   [elements](https://tw.wordpress.org/plugins/tags/elements/)[spots](https://tw.wordpress.org/plugins/tags/spots/)
   [widget](https://tw.wordpress.org/plugins/tags/widget/)
 *  [進階檢視](https://tw.wordpress.org/plugins/spots/advanced/)

## 評分

 5 星，滿分為 5 星

 *  [  10 個 5 星使用者評論     ](https://wordpress.org/support/plugin/spots/reviews/?filter=5)
 *  [  0 個 4 星使用者評論     ](https://wordpress.org/support/plugin/spots/reviews/?filter=4)
 *  [  0 個 3 星使用者評論     ](https://wordpress.org/support/plugin/spots/reviews/?filter=3)
 *  [  0 個 2 星使用者評論     ](https://wordpress.org/support/plugin/spots/reviews/?filter=2)
 *  [  0 個 1 星使用者評論     ](https://wordpress.org/support/plugin/spots/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/spots/reviews/#new-post)

[查看全部使用者評論](https://wordpress.org/support/plugin/spots/reviews/)

## 參與者

 *   [ interconnectit ](https://profiles.wordpress.org/interconnectit/)
 *   [ Spectacula ](https://profiles.wordpress.org/spectacula/)
 *   [ cm2creative ](https://profiles.wordpress.org/cm2creative/)

## 技術支援

使用者可在技術支援論壇提出意見反應或使用問題。

 [檢視技術支援論壇](https://wordpress.org/support/plugin/spots/)

## 贊助

想要支援這個外掛的發展嗎？

 [ 贊助這個外掛 ](http://interconnectit.com/2364/announcing-spots/)