=== danixland-wporg-stats ===
Contributors: danixland
Donate link: http://danix.xyz
Tags: widget, sidebar, links, plugins, list
Requires at least: 4.6
Tested up to: 4.9.7
Stable tag: 0.1

This widget will display a list of plugins by the same author hosted on the WordPress.org plugins directory.

== Description ==

danixland-wporg.stats is a plugin that adds a new widget to be used on the Sidebar (or wherever you like) and some useful shortcodes.
This widget will show a list of plugins by the same author, hosted on the WordPress Plugins directory. It uses the wordpress.org API to fetch all the details and it's able to show links to the plugin page on wordpress.org or to the URI specified by the author inside the plugin itself. Other stats displayed by the plugin are the total number of downloads for all the plugins, average rating per plugin and total average. Soon the plugin will be able to display even more stats.
If an author has used the assets directory to store the plugin's icons, danixland-wporg-stats is able to fetch and display the icons as well.
The plugin ships with a few shortcodes to embed your stats inside your posts or pages. You can use it on a landing page for your plugins or, like I do, inside a custom post type page to display stats about the plugins I write.


== Installation ==

Installing danixland-wporg.stats is straightforward and requires just a few seconds:

If you use the **"Add New Plugin"** pane from your dashboard just install it and activate it, then proceed to the last step and configure it.
Otherwise follow these steps:

1. Download the latest version of the plugin.
1. If using the "Install Plugins->Upload" section on the WordPress admin area just upload the zip file, otherwise unpack the zip file and upload the **"danixland-wporg-stats"** directory inside the "wp-content/plugins" directory of your WordPress installation using your favourite ftp client.
1. Activate the plugin through the 'Plugins' menu in WordPress.
1. Add the widget to your sidebar from Appearance->Widgets.
1. Configure the widget options through the panel which can be accessed from the Appearance->Widgets page.

== Frequently Asked Questions ==

= What can I do to customize even more the appearance of the widget? =

The code generated by the plugin is wrapped in an HTML element with class `widget_danixland-wporg-stats`, what kind of element is decided by your theme, if unsure ask his creator. Inside this element you'll find the content of the widget wrapped inside a div with class `dnxwporg-container`. 
Contained in that element you'll find a div with the description and following there's a list of links for the plugins.

Here's every single id and class used in this plugin:

* `.widget_danixland-wporg-stats`
	* `.dnxwporg_container`
	* `.dnxwporg_description`
		* `.dnxwporg-pl-standard-desc`
		* `.dnxwporg-pl-custom-desc`
	* `.dnxwporg_pl_list_container`
		* `.dnxwporg_pl_list`
			* `.dnxwporg_pl_item`
			* `.dnxwporg-pl-link`
				* `.dnxwporg-pl-link-icon`
				* `.dnxwporg-pl-link-name`
			* `.dnxwporg-pl-stats`
				* `.dnxwporg-pl-tot-dloads`
				* `.dnxwporg-pl-avg-vote`

This plugin ships with no styling on pourpose, it's up to you to add the styling needed for it to look at it's best on your pages.

= I'm stuck with your plugin and don't seem to be able to customize it/make it work, can you help me? =

Of course, you can ask for help on [the forums](http://wordpress.org/support/) or write a comment on the main article for this plugin on [my site](https://danix.xyz/?p=3745), I'll reply ASAP ;)

= I'd like this plugin to be translated in my language, can you do this for me? =

Soon I'll publish  a .POT file that can be used to create a translation of the plugin in your language, so if you're familiar with english you can help by providing a translation and it will be added to future versions of the plugin along with a link to your site on these pages ;)

A number of softwares exists to help you with .po files, like [POEdit](http://sourceforge.net/projects/poedit/) or [Lokalize](http://userbase.kde.org/Lokalize "for kde users")

####If you have any other questions feel free to ask

== Screenshots ==

1. The plugin widget as seen in the admin area.
2. The widget with standard description as seen in the TwentySeventeen theme without any styling.
3. The widget In my custom theme with styling added to it.
3. The widget In my custom theme with a custom description.

== Changelog ==

= 0.1 =
* This is the first version of the plugin.

== Upgrade Notice ==

= 0.1 =
No upgrade since this is the first version ;)



== ToDo list ==

* .POT file to allow translators to translate the plugin.
* bugfixing.
* theme directory support.
* custom tags inside the description.
* average downloads and more stats coming soon...
* I'm open to suggestions, so don't be shy.
