Jump to content


Developer Resources

7 files

  1. Free

    Build App from Dev Center

    This plugin will help you not to waste your time everytime you need to build your app to test it on public side. Currently you can do this by going to main Applications page and selecting Build from the app menu.


       (0 reviews)


  2. Free

    The Dev Toolbox

    Note: It has been brought to my attention that people are using this on IPS community in the cloud and on their live sites causing issues for IPS Support. These tools are designed and their intended use are on localhost and/or absolute development environments. these tools have zero value outside of development, please use wisely, if you are not a developer or do not intend to use them in a developer environment, these tools are unlikely meant for you.
    The Dev Toolbox is  a group of applications, designed with making working with IPS easier, and to reduce overall production time. There are a total of 6 apps (well a total of 7, but the 7th one is required to be installed with any of the others, as it contains data and code the rest of the apps use to function). 
    These applications are being provided free of charge to the IPS developer community, but I ask if you find them useful or lifesaving, consider making a donation of any amount, to help ensure the future development of these fantastic tools.
    if you would like to access the git repo:
    there will be two branches, master and develop. master will be what is found here in the download and develop will be any fixes, features, etc, that are in the works, so it might not be ready for general use. if you want access to be able to push, send me a PM with your bitbucket name/email and i will consider adding you.
    Here is a list of the apps and what they do (how they can benefit you).
    DT Proxy:
    This application will be most useful for those who use IDE's, especially if you use PHPStorm with the PHP-Toolbox plugin. Once you run it, it will create proxy class for IPS classes (most IDE's are unable to correlate an IPS class, to a class used in the code, due to the use of the _ in the class name). it will also attempt to create property tags for Database columns and the setters and getters found in your code. This is useful for autocomplete and code inspection in your IDE (will make it possible for the IDE to map the class's and their method usage).
    Php-Toolbox Improvements:
    PHP-Toolbox is a plugin for phpstorm, that makes it possible to add autocompletes for methods, and alter the return type as well.
    Template Return Type: on Theme::getTemplate($group), this will trigger a return type that matches the $group param of the method. this will then provide possible templates that the group can provide. this is limited due to only $group being required, so it might not return the "right" template (as groups and template names aren't regulated like class names are). In my testing and use, this feature is about 95% accurate most of the time. It drastically goes up, the more unique the template name is compared to others. say you have a group called "forms" with a template in it called 'text.phtml', since IPS also has this, it could potentially return the wrong one (depends really on which order the template was processed in). Application Hinting: there are several methods in IPS that require an "app" name in their parameter, this builds a list of app names from the apps installed to "show up" when those methods are called. Table name Hinting: this is for any method that calls a Database table name, dt proxy will generate a list of table names based on the tables present at execution time. Language String Hinting: will provide a list of available language strings that can be used. Template Group Hinting: provides a list of available template groups to most methods that use them as a param. ModPermission Hinting: provides a list of available modpermissions to the methods that use them as a param. Url Hinting: provides a list of available Query Strings that can be used. Furl Hinting: provides a list of available FURL definitions. PHP Core Hinting: adds in additional hinting's and return types for PHP methods. DT Proxy Extension:
    The dtproxy extension, you can add property types for Request and Data\Store. It already includes some of the most common property's found in both, but you can add to this with the extension in your applications.
    DT Dev Center Plus:
    This application extends the features of the developer center for applications in IPS. this will add 3 new tabs to the dev center, along with other improvments.
    Sources: this allows you to create "sources" classes for your application. there are several predefined class types you can choose from. There are also options to handle some of the "mundane" things that are involved in creating several classes. most notably are the AR\Node\Items\Comments\Review classes. with each you have the option of creating the databases at creation with a basic layout (mainly the ID column) and with the prefix used if defined (for nodes/items/comments/review, this will also add too the class and to the table it creates, any required/optional fields for IPS traits or interfaces used).  For nodes and items, it will also create the corresponding module and controller. (this feature can be turned off by turning of "create scaffolding"). Dev Folder: this tab allows you to create "Dev Folder" components, such as Templates and the JS skeletons. it is not as complex as Sources, but it saves time from hunting down and cloning an existing JS/template and removing the bits you don't need. Languages: This tab shows you all the defined language strings for your app, in both jslang and lang.php.  this allows you to add/remove/alter while on the tab. Features:
    Extension Generator: instead of just generating a blank skeleton for extensions, this feature aims to provide a working out of the box extensions. this feature atm only supports FileStorage, ContentRouter and CreateMenu. Adding/Removing Column in Versioning: this feature will allow to easily add in a query to add/remove columns for versions. Extension:
    Dev Center Plus has an extension called "Headerdoc". it is a bit misleading name, but it gives you the ability to do several useful things when building an app.
    Enabled() (bool) : if this is set to true, it will add the classes "doc block" to the file if it doesn't already exist, and if it does, it will only alter it for the files include in the tar (so the file wont be marked as changed by your repo software if you use it).
    IndexEnabled() (bool): if this is set to true, it will add a blank index.html to all the folders and subfolders in your application. to prevent viewing of the directory contents on servers that do not have the directory listing turned off.
    fileSkip() (array): allows you to add a list of files to skip during the build process of the tar. there is also a "global" skip list in the settings of DT Base for this.
    dirSkip(array): allow you to skip entire folds during the build process of the tar. there is also a "global" dir skip list in the settings of DT Base.
    exclude() (array) : allows you add a file or folder here to skip having a "header doc" added to it. useful if you use third party libraries.  will automatically exclude the following directories and files: 'hooks', 'dev', 'data', '3rdparty', '3rd_party', 'vendor', '.git' and '.idea'.
    DT Dev Folder:
    ever misplaced thos pesky dev folders for your app or don't feel like alter table entries to rebuild your "plugin" dev folder manually, or simply doing work for a client and having a conflict with another app/plugin but can't debug it in in_dev due to missing dev folders, well look no further Dev Folder is the app for you. this will generate dev folders for both apps and plugins (will also allow you to install plugins while in_dev is enabled). if you have the app installed and enabled, it will automagically add the dev folders if they don't already exists .
    DT Code:
    I'm not sure where i will be going with this application exactly, right now it will search thru your code looking for lang keys and settings, it will check and verify they are both in use and defined. it can return false positives as these might not always be "defined" in a way it can read it, but can give you the ability to see which language strings are in use and get rid of the "dead" ones and same with settings. if you have any suggestions for things you would want to check in your code, let me know and i will see about implementing this feature.
    DT Content:
    Creates "dummy" content for testing purposes.
    members - generates random members. can select to add members randomly to a random group. forums - generates forums. topics - generates topics. will create between 1 to 30 replies per topic created. posts - randomly adds replies to topic. clubs - creates clubs with random owners and various "types" *note: unlike the "storm" version, when forums are generated they will not create topics (there was a bit of problems with this in storm, so you should create forums first, then create the topics).
    DT Profiler:
    Replaces the IPS "query log" with a more compreshensive "profiler'. to enable you must have the define('QUERY_LOG', true) in your constants.php (if you want the cache log as well, you will need to have define('CACHING_LOG', true); as well).
    Execution: will display the total time a page took to process from start to finish (this isn't the load time, so don't confuse the two :)).  if you click on this tab, it will display how long the framework took and the profiler to execute, so you can rule out the profiler for slowdowns). memory used: The memory used by the page when it was being executed. This feature can be expanded upon by using the Memory class in Profiler. Included Files: shows how many files are included on the page, and if you click on it will show the a list of these files.* Query Log: displays the queries being executed for the page, along with their execution time and memory load. Caching Log: displayes the stores and caches being set or got during execution. Templates: a list of all the templates in use. * CSS: a list of all the CSS files loaded.* JS: a list of all the JS files loaded.* JSVars: a list of the JS Vars defined for use. Logs: shows the most recent logs that were generated (the amount it shows can be changed in the DT Base settings). Debug: if you use the Debug class, you can add debug statements inside your app's methods. this feature uses a long polling script to query the DB for new log entries and adds them here if they are found (useful for debuging Ajax request). if you use DT Dev Center Plus, you can add a permanent Profiler/Debug class to your app, this way you can add the \IPS\myapp\Profiler\Debug::add('key', 'message') to your methods and leave them there safely for future use (as the Profiler\Debug added by Dev Center Plus will create a class that uses __callStatic and checks to see if the parent class exists, other wise it will just be ignored) InfoBar: Gives basic information about the environment, IPS version, PHP version, and Contoller being executed, along with the Method and line number that method begins on.* *: if you have define('DEV_WHOOPS_EDITOR', 'phpstorm'); (or a supported editors) in your constants.php, it will generate a link that will open the file in editor if you have the phpstorm/supported editor protocol configured ( how to's for phpstorm (how to do this in windows) (how to in linux) (how to on mac not sure how well it works as i don't have a mac ?  ) );
    This is a command line application, that you can use to add backslashes to php internal functions and constants. This has been shown to improve performance on php 7+, due to opcode enhancements. this will also improved execution times as php doesn't have to look in the local space and then globalspace for defined functions. instructions in install.txt.
    DT Base:
    This app doesn't do much on its own. it mainly exist as a "core" app, to share usefule features and code among the rest of Dev Toolbox (so we aren't spending a great deal of time reinventing the wheel for common features). It also contains the Settings and DevBar menu. This app is REQUIRED to run any of the other apps, as they heavily depend on its libraries to function correctly.
    There are a ton of features and abilitis i'm probably forgetting to mention here, so why don't you try it yourself, it is free after all. Hope everyone enjoys this! send me any bugs or feedback to my PM's. i wont be supporting this application in my app topic. thanks to everyone who has made this app possible!
    License Note: The Dev Toolbox, where applicable, is released under the 2-Clause BSD License


       (3 reviews)


  3. Free

    (DP42) Export Lang per App

    With this simple plugin you can download separate translations per app


       (1 review)


  4. Free

    Toggle Developers Mode On/Off

    Does there exist in the world a better gif to use as a primary screenshot?
    1) If you install this on a live site to toggle dev mode on and off you ain't real smarts. If I've done my url check right, this cannot be used on live sites. 
    1.1) CIC user? Why are you here? You can't run developers mode on CIC. Also, I check for CIC installation and then stop you from doing something stupid like using this.
    2) You must already have a constants.php file; this won't make one for you.
    2.1) This constants file should have the define( 'IN_DEV', TRUE ); line already in there. True or false; either one. 
    2.2) If you don't have a constants.php file and try to turn dev mode on/off the plugin will insult you, or just tell you it can't be found. 
    2.3) Another good thing to have is a dev folder. I check for that. Just the folder. If you want to enable developers mode with an empty dev folder that's up to you.
    3) This grabs the constants.php content, case insensitive regex for the in_dev true or false, switches yonder true/false, then redirects. You can choose between the Application page or the Plugin page for the redirect in settings.
    4) I'm targeting single quotes for 'IN_DEV', so don't use "IN_DEV" in your constants.php. Yes I could deal with that. I could...
    5) The toggle you seek is on your ACP usermenu.

    6) Can't stand the flask icon? Change them up in settings.
    7) dmt_on and dmt_off are the language bits you want if the existing words are not to your tastes.
    4.2 and 4.3 compatible.


       (1 review)


  5. $2.00

    Advanced WebSite System

    Hello everyone!
    This application allows you to create a website by IP Board 4!
    The operation is simple, everything is based on the IP Board 4 pages system.
    You must create a .html page from your Admin CP, and then, by Admin CP, you must create a database on which to apply your own categories. I suggest you put on the home page of the latest news, instead of categories, so that the graph change is known more!
    Then apply Template uploading your Admin CP.
    All the specifications in the ReadMe.txt that report below.
    I repeat, you will find the directions in ReadMe.txt file.
    I accept suggestions and constructive criticism, this is the first version, is not complete, slowly with upgrades will improve. If you have ideas for what to improve, write it in the comments to let me know
    Here is the site applied to my forum. I do not provide support, it is my personal forum, it is just to let you see how it works.
    If you need support, please contact me by MP, thank you. You can also write in the comments, in case.

    2 purchases   7 downloads

       (1 review)


  6. Free

    (itzrest) Rest API with authentication

    For one of my projects I needed the possibility to read data from my board. I could not use the built in API because one important thing still is missing: user authentication and only get data the user is allowed to read. So I wrote my own REST API, including user authentication with tokens and a fluent data output. Currently it is not possible to write data. But the plan is to implement that feature in the future.
    The plugin is currently in a beta state and available for free. In the future there a plans that you have to purchase it.
    Install the application through uploading it in the ACP Navigate to "Community" > "Itzrest" > "Settings" and insert a random 32 length key. This step is only needed if you want to use authorized access to the API. The key will be used to encode user tokens and authenticate the user if you make API calls. Make sure your webserver supports authentication headers. Otherwise authorized access will not work. That's it. Everything should work like a charme right now. Go on with the next topics Implemented endpoints
    Currently the following endpoints are implemented (more will be available in the future). And again: at the moment it is only possible to read data. You must prefix every endpoint with /restapi".
    Forums /forums /forums/<forumId> /forums/<forumId>/topics /forums/posts /forums/posts/<postId> /forums/topics /forums/topics/<topicId> /forums/topics/<topicId>/posts Core /discover/unread /discover /reactions /reactions/<reactionId> /staff/users /staff/users/<userId> /staff/groups /staff/groups/<groupId> /messenger/folders /messenger/folders/<folderId> /messenger/folders/<folderId>/conversations /messenger/conversations /messenger/conversations/<conversationId> /messenger/conversations/<conversationId>/messages /messenger/messages /messenger/messages/<messageId> Calendar /calendars /calendars/<calendarId> /calendars/<calendarId>/comments /calendars/<calendarId>/events /calendars/comments /calendars/comments/<commentId> /calendars/events /calendars/events/<eventId> /calendars/events/<eventId>/reviews /calendars/events/<eventId>/comments /calendars/reviews /calendars/reviews/<reviewId> Gallery /gallery/albums /gallery/albums/<albumId> /gallery/albums/<albumId>/images /gallery/albums/<albumId>/comments /gallery/categories /gallery/categories/<categoryId> /gallery/categories/<categoryId>/images /gallery/categories/<categoryId>/albums /gallery/reviews /gallery/reviews/<reviewId> /gallery/comments /gallery/comments/<commentId> /gallery/images /gallery/images/<imageId> /gallery/images/<imageId>/comments Authentication /auth/login /auth/authenticate Login as user
    To login as a user you must send a POST Request to the /auth/login endpoint with your username and password:
    curl \ -d username=max\ -d password=secret\ -X POST <baseurl>/restapi/auth/login As result you will get an object with several user data and the most important thing: the access token:
    { "data": { "id": "1", "name": "max", "access_token": "********", "photoUrl": "", "birthday": "" } } Keep the token secret and use it for authorized API calls how described in the step "make authorized requests". If you use authentication it would be the best way if you use a secure (https) connection to make API calls.
    Make requests
    Nothing more than sending a GET request to a specific endpoint:
    curl <baseurl>/restapi/<endpoint> For example: If you want to have all available calendars from your board:
    curl POST <baseurl>/restapi/calendars Your result will be something like that:
    { "data": [ { "id": "1", "title": "Community Calendar", "title_seo": "community-calendar", "color": "#6E4F99" } ] } Make authorized requests
    For authorized requests you need an access token. Append the access token as authorization header and make your request:
    curl \ -H "Authorization: Bearer <token>" \ -X <baseurl>/restapi/forums You can validate if your token is valid by sending a request to the /auth/authenticate endpoint:
    curl \ -H "Authorization: Bearer <token>" \ -X POST <baseurl>/restapi/auth/authenticate As result you should get a valid user object.
    Pagination, order
    If your board has thounsands of posts or threads we must paginate the results. Otherwise the performance of your requests will be horrible. Each endpoint accepts query parameters to sort and paginate your results in an easy way. Therefore each endpoint has a meta node in its result whicht give you information about your current agination state:
    "meta": { "pagination": { "total": "22", "count": "22", "per_page": "25", "current_page": "1", "total_pages": "1", "links": [] } } Now let us filter / paginate and limit our results:
    curl <baseurl>/restapi/forums/2/topics?order=title&orderDirection=asc&limit=5&page=2 We will get the following meta output:
    "meta": { "pagination": { "total": "22", "count": "5", "per_page": "5", "current_page": "2", "total_pages": "5", "links": { "previous": "<baseurl>/restapi/forums/2/topics/?page=1&order=title&orderDirection=asc&limit=5", "next": "<baseurl>/restapi/forums/2/topics/?page=3&order=title&orderDirection=asc&limit=5" } } }  


       (0 reviews)


  7. Free


    Endpoints is a Postman library of the endpoints published for IPS 4.
    In this version I have only included the GET statements as I wouldn't want any destructive action happen. 
    To load the JSON file you will need to download Postman - https://www.getpostman.com
    Once installed you can setup your own environment with your own API keys or OAuth to your IPS install, once your credentials are setup you will be able to test your API called to your site. 
    I have also published the endpoints at this location https://documenter.getpostman.com/view/2850550/ips4-get/RVu5iTiR#f2da1a27-2aa1-4321-b9c2-3683ef0e8122
    Note: I have yet to finish the Gallery and Calendar - caught a head cold ?


       (0 reviews)