Basic Portals

About

A Basic Portal is just a portal that serves the same web page to all clients who are viewing it. You can put whatever you want on this page (an input form, continue button, app download link, etc...).

Creating

1. Open the Evil Portal module on your Pineapples web interface.
2. In the root of the "Work Bench" section, In the drop down menu select "Basic"
3. Type the name of this portal (example: "basic_portal").
4. Click "Create New Portal" to create the portal on the internal storage of the Pineapple (/root/portals/{name}), or if applicable, click "Create On SD" to create the portal on the SD card inserted in your Pineapple (/sd/portals/{name}).

Editing

To edit your portal click on the name of your portal in the list of portals in the work bench. You'll see the work bench UI change to a list of files in your portal. Click "Edit" next to the file you want to edit and you will see the source code there. Be sure to click save when you are done making changes.

Important Files

• index.php
  • This is the web page that the client will see when they visit the captive portal. (This file serves a different purpose for targeted portals!)
• MyPortal.php
  • This file is where all of the server sided logic lives for determining if the client is authorized and can then proceed to using the internet or not. There are a few methods defined in its parent class "Portal" that can be overridden or used in here.
• Helper.php
  • This file contains PHP functions that are intended to be used in index.php