This isn't a question about how to build a WordPress plugin. Rather, what, if any, guides could be applied to how to put together the file architecture of any plugin.

Some other programming languages or libraries have very controlled ways of organizing directories and files. Sometimes this is annoying and highlights the freedom that PHP offers, but on the flip-side WordPress plugins are put together in any fashion as determined by their author.

There isn't a right answer, but my hope is to refine how I, and others, build plugins to make them more friendly for other developers to disect, easier to debug, easier to navigate, and possibly more efficient.

The final question: what do you think is the best way to organize a plugin?

Below are a few sample structures, but in no way is an exhaustive list. Feel free to add your own recommendations.

Assumed Default Structure

• /wp-content
  • /plugins
    • /my-plugin
      • my-plugin.php

Model View Controller (MVC) method

• /wp-content
  • /plugins
    • /my-plugin
      • /controller
        • Controller.php
      • /model
        • Model.php
      • /view
        • view.php
      • my-plugin.php

MVC's three parts:

• The model interacts with the database, querying and saving data, and contains logic.
• The controller would contain template tags and functions that the view would utilize.
• The view is responsible to display the data provided by the model as constructed by the controller.

Organized by type method

• /wp-content
• /plugins
  • /my-plugin
    • /admin
      • admin.php
    • /assets
      • css/
      • images/
    • /classes
      • my-class.php
    • /lang
      • my-es_ES.mo
    • /templates
      • my-template.php
    • /widgets
      • my-widget.php
    • my-plugin.php

WordPress Plugin Boilerplate

Available on Github

Based on the Plugin API, Coding Standards, and Documentation Standards.

• /wp-content
  • /plugins
    • /my-plugin
      • /admin
        • /css
        • /js
        • /partials
        • my-plugin-admin.php
      • /includes
        • my_plugin_activator.php
        • my_plugin_deactivator.php
        • my_plugin_i18n.php
        • my_plugin_loader.php
        • my_plugin.php
      • /languages
        • my_plugin.pot
      • /public
        • /css
        • /js
        • /partials
        • my-plugin-public.php
      • LICENSE.txt
      • README.txt
      • index.php
      • my-plugin.php
      • uninstall.php

Loosely organized method

• /wp-content
• /plugins
  • /my-plugin
    • css/
    • images/
    • js/
    • my-admin.php
    • my-class.php
    • my-template.php
    • my-widget.php
    • my-plugin.php