f44b7e0ca3
This tries to address table overflow problems we have and is only meant as a base for further discussion. It gets rid of table overflow, e.g. in the dashboard on small mobile screens by setting "table-layout: fixed;" for all tables. This breaks the stacked-to-horizontal emulation, so the workaround there is to switch it off, which requires a proper viewport detection. While there, fiddle with the logs template, but for these non- hooked stacked-to-horizontal tables the fix for table-layout can't be undone, because that would break the original fix in the first place. Moral of the story: tables are deprecated. ;)
OPNsense GUI and system management
The OPNsense project invites developers to start contributing to the code base. For your own purpose or even better to join us in creating the best open source firewall available.
The build process has been designed to make it easy for anyone to build and write code. The main outline of the new codebase is available at:
https://wiki.opnsense.org/index.php/Develop:Architecture
Our aim is to gradually evolve to a new codebase instead of using a big bang approach into something new.
Build tools
To create working software like OPNsense you need the sources and the tools to build it. The build tools for OPNsense are freely available.
Notes on how to build OPNsense can be found in the tools repository:
https://github.com/opnsense/tools
Contribute
You can contribute to the project in many ways, e.g. testing functionality, sending in bug reports or creating pull requests directly via GitHub. Any help is always very welcome!
License
OPNsense is and will always be available under the 2-Clause BSD license:
http://opensource.org/licenses/BSD-2-Clause
Every contribution made to the project must be licensed under the same conditions in order to keep OPNsense truly free and accessible for everybody.
Makefile targets
The repository offers a couple of targets that either tie into tools.git build processes or are aimed at fast development.
make package
A package of the current state of the repository can be created using this target. It may require several packages to be installed. The target will try to assist in case of failure, e.g. when a missing file needs to be fetched from an external location.
Several OPTIONS exist to customise the package:
- CORE_DEPENDS: a list of required dependencies for the package
- CORE_ORIGIN: sets a FreeBSD compatible package/ports origin
- FLAVOUR: can be set to "OpenSSL" (default) or "LibreSSL"
- CORE_COMMENT: a short description of the package
- CORE_MAINTAINER: email of the package maintainer
- CORE_WWW: web url of the package
- CORE_NAME: sets a package name
Options are passed in the following form:
# make package CORE_NAME=my_new_name
make upgrade
Upgrade will run the package build and attempt to replace the currently installed package in the system. Safety measures may prevent the target from succeeding. The following rules apply:
In order to install from the master branch of this repository, the opnsense-devel package must be installed:
# pkg install opnsense-devel
In order to install from the stable branches of this repository, the opnsense-stable package must be installed:
# pkg install opnsense-stable
make mount
Live-mount the package into the current system. This will overlay the repository over /usr/local and will instantly change the GUI accordingly. In this mode changes can be quickly tested.
Note that live-mount will not be persistent after reboot and causes trouble when used while upgrading firmware as packages get installed into the repository as oppsed to the system. Use with care.
make umount
Disable the live-mount feature.
make lint
Run serveral syntax checks on the repository. This is recommended before issuing a pull request on GitHub.