├── LICENSE
├── README.md
├── demo.gif
└── src
├── Cells
├── Counter
│ ├── CounterCell.php
│ └── counter.php
├── CounterSigned
│ ├── CounterSignedCell.php
│ └── counter_signed.php
├── TableAdvanced
│ ├── TableAdvancedCell.php
│ └── table_advanced.php
└── TableSimple
│ ├── TableSimpleCell.php
│ └── table_simple.php
├── Config
├── Registrar.php
└── Routes.php
├── Controllers
├── Books.php
├── Paragraphs.php
└── Tasks.php
├── Database
├── Migrations
│ ├── .gitkeep
│ ├── 2022-10-01-080730_AddBooksTable.php
│ ├── 2022-12-04-110940_AddTasksTable.php
│ └── 2022-12-12-101738_AddParagraphsTable.php
└── Seeds
│ ├── .gitkeep
│ ├── SeedBooksTable.php
│ ├── SeedDemo.php
│ └── SeedParagraphsTable.php
├── Helpers
└── alert_helper.php
├── Models
├── .gitkeep
├── BookModel.php
├── ParagraphModel.php
└── TaskModel.php
├── TableHelper.php
└── Views
├── Pager
└── default_htmx_full.php
├── books
├── index.php
├── table.php
├── table_row.php
├── table_row_add.php
└── table_row_edit.php
├── cells
└── index.php
├── home.php
├── layout.php
├── paragraphs
├── edit.php
└── index.php
└── tasks
├── index.php
├── task.php
└── tasks_summary.php
/LICENSE:
--------------------------------------------------------------------------------
1 | MIT License
2 |
3 | Copyright (c) 2022 Michal Sniatala
4 |
5 | Permission is hereby granted, free of charge, to any person obtaining a copy
6 | of this software and associated documentation files (the "Software"), to deal
7 | in the Software without restriction, including without limitation the rights
8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 |
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 |
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # CodeIgniter HTMX Demo
2 |
3 | This is a demo for [CodeIgniter HTMX](https://github.com/michalsn/codeigniter-htmx) helper library. Demo requires:
4 |
5 | - CodeIgniter HTMX library installed via composer or manually,
6 | - CodeIgniter 4.3 or later version.
7 |
8 | 
9 |
10 | #### Available demos:
11 |
12 | - **Books** - searching, pagination, inline edit
13 | - **Tasks** - events
14 | - **Paragraphs** - sorting, modal edit
15 | - **Controlled Cells** - widget like components, signed-urls (the last one requires [CodeIgniter Signed-URL](https://github.com/michalsn/codeigniter-signed-url) library)
16 |
17 | ## Installation
18 |
19 | 1. Install [CodeIgniter 4](https://codeigniter.com/) with composer (command below) or [manually](https://codeigniter.com/user_guide/installation/installing_manual.html).
20 | ```console
21 | composer create-project codeigniter4/appstarter codeigniterhtmx
22 | cd codeigniterhtmx
23 | ```
24 | 2. Install [CodeIgniter HTMX](https://github.com/michalsn/codeigniter-htmx) library with composer (command below) or [manually](https://michalsn.github.io/codeigniter-htmx/installation/#manual-installation).
25 | ```console
26 | composer require michalsn/codeigniter-htmx
27 | ```
28 | 3. Manually download ZIP file of this project and place it in the desired folder.
29 |
30 | - The example will assume that it will be `codeigniterhtmx/app/ThirdParty/htmx-demo`.
31 | - Then enable it by editing the `codeigniterhtmx/app/Config/Autoload.php` file and adding the `Michalsn\CodeIgniterHtmxDemo` namespace to the `$psr4` array, like in the below example:
32 |
33 | ```php
34 | APPPATH, // For custom app namespace
40 | 'Config' => APPPATH . 'Config',
41 | 'Michalsn\CodeIgniterHtmxDemo' => APPPATH . 'ThirdParty/htmx-demo/src',
42 | ];
43 |
44 | // ...
45 | ```
46 |
47 | ## Database
48 |
49 | First, make sure to create a database for the project. You can name it `codeigniterhtmx` and set credentials for the database connection in `codeigniterhtmx/app/Config/Database.php`, see [framework's user guide](https://codeigniter.com/user_guide/database/configuration.html) for more information.
50 |
51 | Before running the examples you have to migrate the database. Make sure you have set correct credentials to the database and then run the command:
52 | ```console
53 | php spark migrate --all
54 | ```
55 |
56 | And preferably run the seeds:
57 |
58 | **For Unix:**
59 | ```console
60 | php spark db:seed Michalsn\\CodeIgniterHtmxDemo\\Database\\Seeds\\SeedDemo
61 | ```
62 |
63 | **For Windows:**
64 | ```console
65 | php spark db:seed Michalsn\CodeIgniterHtmxDemo\Database\Seeds\SeedDemo
66 | ```
67 |
68 | ## Running the demo
69 |
70 | The default route to the demo page is `demo`.
--------------------------------------------------------------------------------
/demo.gif:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/michalsn/codeigniter-htmx-demo/99507f0de424a2148575caeb89e59099c85b9e02/demo.gif
--------------------------------------------------------------------------------
/src/Cells/Counter/CounterCell.php:
--------------------------------------------------------------------------------
1 | count++;
19 | return $this->render();
20 | }
21 |
22 | /**
23 | * Decrement
24 | *
25 | * @return void
26 | */
27 | public function decrement()
28 | {
29 | $this->count--;
30 | return $this->render();
31 | }
32 | }
33 |
34 |
--------------------------------------------------------------------------------
/src/Cells/Counter/counter.php:
--------------------------------------------------------------------------------
1 |
A Signed URL library will prevent manual URL manipulation. It can come in handy on many occasions. You can learn more here.
49 |
50 |
51 |
52 |
53 |
54 |
55 |
Did you know?
56 |
If you install the codeigniter-signed-url library, you will get access to the new example for the Counter Cell, which will prevent manual URL manipulation.
76 | Controlled Cells (widget like components, signed-urls)
77 |
78 |
79 |
80 |
81 | Note that the demos were prepared to show as many HTMX features as possible. And they do not always take the most optimal path to achieve the goal.
82 |