├── Block
    └── HelloWorld.php
├── Controller
    └── Index
    │   └── Index.php
├── README.md
├── composer.json
├── etc
    ├── frontend
    │   └── routes.xml
    └── module.xml
├── registration.php
└── view
    └── frontend
        ├── layout
            └── helloworld_index_index.xml
        └── templates
            └── helloworld.phtml


/Block/HelloWorld.php:
--------------------------------------------------------------------------------
1 | <?php
2 | namespace Ashsmith\HelloWorld\Block;
3 | class HelloWorld extends \Magento\Framework\View\Element\Template
4 | {
5 | }
6 | 


--------------------------------------------------------------------------------
/Controller/Index/Index.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Ashsmith\HelloWorld\Controller\Index;
 3 | 
 4 | class Index extends \Magento\Framework\App\Action\Action
 5 | {
 6 |     /**
 7 |      * @var \Magento\Framework\View\Result\PageFactory
 8 |      */
 9 |     protected $resultPageFactory;
10 | 
11 |     /**
12 |      * @param \Magento\Framework\App\Action\Context $context
13 |      * @param \Magento\Framework\View\Result\PageFactory resultPageFactory
14 |      */
15 |     public function __construct(
16 |         \Magento\Framework\App\Action\Context $context,
17 |         \Magento\Framework\View\Result\PageFactory $resultPageFactory
18 |     )
19 |     {
20 |         $this->resultPageFactory = $resultPageFactory;
21 |         parent::__construct($context);
22 |     }
23 | 
24 |     /**
25 |      * Default customer account page
26 |      *
27 |      * @return void
28 |      */
29 |     public function execute()
30 |     {
31 |         return $this->resultPageFactory->create();
32 |     }
33 | }
34 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | #Magento 2 Controller Module Example
 2 | 
 3 | From my blog post: https://www.ashsmith.io/2014/12/simple-magento2-controller-module/
 4 | 
 5 | ## To install:
 6 | 
 7 | Install with Composer!
 8 | 
 9 |     composer require ashsmith/magento2-controller-module:2.0.*
10 | 
11 | Then you'll need to modify `app/etc/config.php` to activate the module. It should look a little like this:
12 | 
13 |     <?php
14 |     return array (
15 |         'modules' =>
16 |         array (
17 |             ...
18 |             'Ashsmith_HelloWorld' => 1,
19 |             ),
20 |           );
21 | 


--------------------------------------------------------------------------------
/composer.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "name": "ashsmith/magento2-controller-module",
 3 |   "description": "A basic Magento 2 module with a controller",
 4 |   "type": "magento2-module",
 5 |   "version": "2.0.1",
 6 |   "license": [
 7 |     "OSL-3.0",
 8 |     "AFL-3.0"
 9 |   ],
10 |   "require": {
11 |     "php": "~5.5.0|~5.6.0|~7.0",
12 |     "magento/magento-composer-installer": "*"
13 |   },
14 |   "extra": {
15 |     "map": [
16 |       [
17 |         "*",
18 |         "Ashsmith/HelloWorld"
19 |       ]
20 |     ]
21 |   }
22 | }
23 | 


--------------------------------------------------------------------------------
/etc/frontend/routes.xml:
--------------------------------------------------------------------------------
1 | <config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../../../../../lib/internal/Magento/Framework/App/etc/routes.xsd">
2 |     <router id="standard">
3 |         <route id="helloworld" frontName="helloworld">
4 |             <module name="Ashsmith_HelloWorld" />
5 |         </route>
6 |     </router>
7 | </config>
8 | 


--------------------------------------------------------------------------------
/etc/module.xml:
--------------------------------------------------------------------------------
1 | <?xml version="1.0"?>
2 | <config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../../../../lib/internal/Magento/Framework/Module/etc/module.xsd">
3 |     <module name="Ashsmith_HelloWorld" schema_version="1.0.0" setup_version="1.0.0" />
4 | </config>
5 | 


--------------------------------------------------------------------------------
/registration.php:
--------------------------------------------------------------------------------
1 | <?php
2 | \Magento\Framework\Component\ComponentRegistrar::register(
3 |     \Magento\Framework\Component\ComponentRegistrar::MODULE,
4 |     'Ashsmith_HelloWorld',
5 |     __DIR__
6 | );
7 | 


--------------------------------------------------------------------------------
/view/frontend/layout/helloworld_index_index.xml:
--------------------------------------------------------------------------------
1 | <page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" layout="1column" xsi:noNamespaceSchemaLocation="../../../../../../../lib/internal/Magento/Framework/View/Layout/etc/page_configuration.xsd">
2 |     <body>
3 |         <referenceContainer name="content">
4 |             <block class="Ashsmith\HelloWorld\Block\HelloWorld" name="helloworld" template="helloworld.phtml" />
5 |         </referenceContainer>
6 |     </body>
7 | </page>
8 | 


--------------------------------------------------------------------------------
/view/frontend/templates/helloworld.phtml:
--------------------------------------------------------------------------------
1 | <?php /** @var $block \Ashsmith\HelloWorld\Block\HelloWorld */?>
2 | <h1>Hello World!</h1>
3 | <p>We created a block! Our block class is: <?php echo get_class($block) ?>!</p>
4 | 


--------------------------------------------------------------------------------