README.md
1IfAuthEx Plugin for DokuWiki
2===
3**Toggle DokuWiki page content based on users and groups with arbitrary boolean expressions.**
4
5**Latest release: v0.3, [download here](https://git.mittelab.org/proj/ifauthex-dokuwiki-plugin/-/jobs/artifacts/v0.3/raw/ifauthex.zip?job=package).**
6You can use the download link URL to install it on DokuWiki directly.
7
8**GitHub mirror (issues and PR): [https://github.com/mittelab/ifauthex-dokuwiki-plugin](https://github.com/mittelab/ifauthex-dokuwiki-plugin)**
9Feel free to [open an issue](https://github.com/mittelab/ifauthex-dokuwiki-plugin/issues) or [make a pull request](https://github.com/mittelab/ifauthex-dokuwiki-plugin/pulls) here.
10
11**Documentation: [https://www.dokuwiki.org/plugin:ifauthex](https://www.dokuwiki.org/plugin:ifauthex)**
12
13**Main repository: [https://git.mittelab.org/proj/ifauthex-dokuwiki-plugin](https://git.mittelab.org/proj/ifauthex-dokuwiki-plugin)**
14Development, testing and packaging happens on the main repo.
15
16**Last commit:** [](https://git.mittelab.org/proj/ifauthex-dokuwiki-plugin/commits/master)
17
18Rationale
19---
20This plugin intends to replace the [IfAuth plugin](https://www.dokuwiki.org/plugin:ifauth), but
21it's an independent reboot. IfAuth can only "or" different expressions, therefore it's not possible
22to target expressions like `@user && !@admin`. IfAuthEx fixes these limtations extending the syntax
23to arbitrary boolean expression (in for a penny...), that uses PHP standard logical operators `||`,
24`&&`, `!`, as well as parentheses.
25
26Plugin notes
27---
28
29All documentation for this plugin can be found at
30[https://www.dokuwiki.org/plugin:ifauthex](https://www.dokuwiki.org/plugin:ifauthex)
31
32If you install this plugin manually, make sure it is installed in
33`lib/plugins/ifauthex/` - if the folder is called different it
34will not work!
35
36Please refer to [http://www.dokuwiki.org/plugins](http://www.dokuwiki.org/plugins) for additional info
37on how to install plugins in DokuWiki.
38
39---
40
41Copyright (C) Pietro Saccardi <lizardm4@gmail.com>
42
43This program is free software; you can redistribute it and/or modify
44it under the terms of the GNU General Public License as published by
45the Free Software Foundation; version 2 of the License
46
47This program is distributed in the hope that it will be useful,
48but WITHOUT ANY WARRANTY; without even the implied warranty of
49MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
50GNU General Public License for more details.
51
52See the LICENSING file for details
53
){kind=link}