<p>The plugin is mainly an example of how to use the new <a href="http://buildwithcraft.com/docs/plugins/hooks-reference#modifyEntrySources" rel="nofollow">modifyEntrySources</a> hook.</p>

<p>Go to the entry index page and you should have the category groups you selected in the menu on the left hand side.</p>

<p>If so, click one of the categories in the left hand menu and you'll see any entries that have category fields with them selected.</p>

CC BY-SA 3.0
2015-02-21T05:56:33.370Z
2015-02-21T05:56:33.370Z
Brad Bell
<p>IMO, the plugin serves two purposes... one of which is simply to serve as an example for how to use the <a href="http://buildwithcraft.com/docs/plugins/hooks-reference#modifyEntrySources" rel="nofollow"><code>modifyEntrySources</code> hook</a>.</p>

<p>Beyond that, the plugin will provide you with an alternative way to view your Entries. You'll notice that the categories which you selected now appear as <strong>entry sources</strong> on the left sidebar under the Entries tab.</p>

<p>Oh, and <a href="http://buildwithcraft.com/updates#build2629" rel="nofollow">Craft 2.3.2629 is required...</a> that's when <code>modifyEntrySources</code> was introduced.</p>

CC BY-SA 3.0
2015-02-21T05:57:35.190Z
I'm getting old... you beat me.
Brad Bell
CC BY-SA 3.0
2015-02-21T06:03:07.243Z
http://blodsmak.no/wp-content/uploads/2012/03/great-success-borat-macro-yes-1275741053s.jpg
Lindsey D
CC BY-SA 3.0
2015-02-21T07:56:14.157Z
hmmm... that's what I assumed as well. But I'm on the entries index page and see nothing in the left hand column. Must be broke?! I assume it works with entries defined in both channels and structures?
Douglas McDonald
CC BY-SA 3.0
2015-02-21T08:05:05.253Z
Triple-check that the plugin is enabled and the Category Groups you want are selected in the plugin's settings. It's working great for me! If you're still having problems, maybe file a bug report with P&T.
Lindsey D
CC BY-SA 3.0
2015-02-21T08:06:19.517Z
Oh, and [**Craft 2.3.2629** is required...](http://buildwithcraft.com/updates#build2629) that's when `modifyEntrySources` was introduced.
Lindsey D
CC BY-SA 3.0
2015-02-21T08:11:58.423Z
haha... ah yes... having a version of craft which supports categorySources would probably help a lot! Just updated. Much better. Thanks.
Douglas McDonald
CC BY-SA 3.0
2015-02-21T08:17:40.580Z
speaking of which, it would probably be good to have a craft dependency variable you could define in your plugin, that craft would check against the version and prevent installation.
Douglas McDonald
CC BY-SA 3.0
2015-02-21T08:19:25.743Z
It's up on Github... I'm sure a pull request would be welcome. ;)
Lindsey D
CC BY-SA 3.0
2015-02-21T05:52:42.053Z
2015-02-23T18:11:04.957Z
2015-02-23T18:11:04.957Z
Lindsey D
<p>A little off-topic, but wondering if someone can shed some light on the <a href="https://github.com/pixelandtonic/CategorySources" rel="nofollow">CategorySources</a> plugin.</p>

<p>A client site has hundreds of articles (in an 'articles' structure) that are currently assigned to categories via a categories field. It would be great if they could view the articles by category (which I assume is what the plugin is for?). I installed, activated, and selected the category groups in the plugin settings, but I'm not seeing any obvious changes to the CP. Where are these mysterious category sources? Or am I missing the point? The plugin docs are a bit light on specifics.</p>

<plugins>
What does the CategorySources plugin do?
# What does the CategorySources plugin do?

(Asked by: username_0 on 2015-02-21)

A little off-topic, but wondering if someone can shed some light on the [CategorySources](https://github.com/pixelandtonic/CategorySources) plugin.

A client site has hundreds of articles (in an 'articles' structure) that are currently assigned to categories via a categories field. It would be great if they could view the articles by category (which I assume is what the plugin is for?). I installed, activated, and selected the category groups in the plugin settings, but I'm not seeing any obvious changes to the CP. Where are these mysterious category sources? Or am I missing the point? The plugin docs are a bit light on specifics.

**Tags:** plugins


---

## 2 answers

### Answer by username_2 on 2015-02-21. Score: 6 | Accepted answer

IMO, the plugin serves two purposes... one of which is simply to serve as an example for how to use the [`modifyEntrySources` hook](http://buildwithcraft.com/docs/plugins/hooks-reference#modifyEntrySources).

Beyond that, the plugin will provide you with an alternative way to view your Entries. You'll notice that the categories which you selected now appear as **entry sources** on the left sidebar under the Entries tab.

Oh, and [Craft 2.3.2629 is required...](http://buildwithcraft.com/updates#build2629) that's when `modifyEntrySources` was introduced.

> **Comments:**
> **username_1**: I'm getting old... you beat me.  
> **username_2**: http://blodsmak.no/wp-content/uploads/2012/03/great-success-borat-macro-yes-1275741053s.jpg  
> **username_0**: hmmm... that's what I assumed as well. But I'm on the entries index page and see nothing in the left hand column. Must be broke?! I assume it works with entries defined in both channels and structures?  
> **username_2**: Triple-check that the plugin is enabled and the Category Groups you want are selected in the plugin's settings. It's working great for me! If you're still having problems, maybe file a bug report with P&T.  
> **username_2**: Oh, and [**Craft 2.3.2629** is required...](http://buildwithcraft.com/updates#build2629) that's when `modifyEntrySources` was introduced.  
> **username_0**: haha... ah yes... having a version of craft which supports categorySources would probably help a lot! Just updated. Much better. Thanks.  
> **username_0**: speaking of which, it would probably be good to have a craft dependency variable you could define in your plugin, that craft would check against the version and prevent installation.  
> **username_2**: It's up on Github... I'm sure a pull request would be welcome. ;)  

---

### Answer by username_1 on 2015-02-21. Score: 2

The plugin is mainly an example of how to use the new [modifyEntrySources](http://buildwithcraft.com/docs/plugins/hooks-reference#modifyEntrySources) hook.

Go to the entry index page and you should have the category groups you selected in the menu on the left hand side.

If so, click one of the categories in the left hand menu and you'll see any entries that have category fields with them selected.


---

