Page tree
Skip to end of metadata
Go to start of metadata


null block(int $callback_id, Closure $callback)

Requires: phpFox 4.3+

Connects a block in specific locations and routes based on the JSON Configuration assignment for blocks.



Block location number.


Callback function that will be executed when the block is to be loaded.


Assigning blocks in your app.json file. 

   "id": "Sample",
   "name": "My Sample App",
   "version": 1,
   "icon": "",
   "blocks": [
         "callback": "sample_block",
         "route": "route_v",
         "location": 3
         "callback": "sample_block_with_view",
         "route": "core.index-member",
         "location": 3


Connect block assignments in your start.php 


 * Adds a block and assigns it to "sample_block"
block('sample_block', function() {
   $html = '<div class="block"><div class="title">Hello World!</div><div class="content">...</div></div>';

   return $html;

 * Adds a block and assigns it to "sample_block_with_view" with an HTML view
block('sample_block_with_view', function() {

   return view('@Sample/block.html');


!Important: Make sure to clear your sites cache after assigning a block.


Since 4.3+

Blocks are not required to be included in a route and is no longer the advised way to create a block. While old methods are still supported in 4.3, they will be depreciated in the future. The change in how blocks work in 4.3 is to give clients the ability to re-position your blocks from the AdminCP.


HTML Views

If you use an HTML view via the view() function you must prefix the HTML with your apps ID (e.g. @Sample/)


Identifying Route Names

 Finding the name of a route can be hard at times, enable Techie Mode to make things easier.


  • No labels