{"id":13702251,"url":"https://github.com/open-ecommerce/helptext","last_synced_at":"2025-11-05T02:30:22.364Z","repository":{"id":57032001,"uuid":"61735450","full_name":"open-ecommerce/helptext","owner":"open-ecommerce","description":"HelpText+ Is an open source app for sms managment in non profit organizations","archived":false,"fork":false,"pushed_at":"2017-04-24T11:53:25.000Z","size":89979,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-12-27T11:21:21.336Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/open-ecommerce.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-06-22T16:43:23.000Z","updated_at":"2017-11-14T09:47:26.000Z","dependencies_parsed_at":"2022-08-23T18:50:48.528Z","dependency_job_id":null,"html_url":"https://github.com/open-ecommerce/helptext","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-ecommerce%2Fhelptext","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-ecommerce%2Fhelptext/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-ecommerce%2Fhelptext/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-ecommerce%2Fhelptext/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/open-ecommerce","download_url":"https://codeload.github.com/open-ecommerce/helptext/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239449408,"owners_count":19640530,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-02T21:00:32.815Z","updated_at":"2025-11-05T02:30:22.328Z","avatar_url":"https://github.com/open-ecommerce.png","language":"PHP","funding_links":[],"categories":["Awesome tech for good projects"],"sub_categories":[],"readme":"![Yii2, Phundament, helptext, Less and Gulp ](hero.png)\n\n#Project Based in Yii2 and Phundament4 with Gulp as assets generation tool\n\nhelptext\nThis project is intended as a live, working pilot for a platform to empower existing non-profit helplines by providing access and management of mobile text and other emerging ways of communication. The platform will allow integration with their existing systems as well as upgrade, to enable them to keep-up and transfer their standards, knowledge and skills with ease.\n\n\n\n## Some features\n- Simplify configuration file by [Phundamental 4](https://github.com/phundament/app)\n- Dashboard theme based in [AdminLTE 2](http://almsaeedstudio.com/AdminLTE) for backend with extra plugins for chars.\n- User Managment with RDAC to use roles and permisions.\n- Migrations support with [yii2-migration-utility by Jon Chambers] (https://github.com/c006/yii2-migration-utility)\n- Gulp configuration based in [Jacob Moen zurbified] (https://github.com/jacmoe/yii2-app-basic-zurbified) but with out foundation :)\n- Multi Phone Calls and SMS providers integration (ie. Twilio)\n\n\n# Installation\n## Prerequisites\nBefore you start, make sure you have installed [composer](https://getcomposer.org/) and [Node.js](http://nodejs.org/).\nIf you are on Debian or Ubuntu you might also want to install the [libnotify-bin](https://packages.debian.org/jessie/libnotify-bin) package, which is used by Gulp to inform you about its status.\n\n### Duplicate the .env-dist file\nadd a key http://randomkeygen.com/\n\n\n### Gulp\ninstall gulp globally if you haven't done so before\n\n```\nnpm install -g gulp-cli\n```\n### Browsersync\ninstall browsersync globally if you haven't done so before\n\n```\nnpm install -g browser-sync\n```\n## Composer\n```\ncomposer global require \"fxp/composer-asset-plugin:~1.1.1\"\ncomposer update\n```\n\n## Post-installation\n\ninitialize the application, choose \"development\"\n```\n./init\n```\n\n### Post-installation\nInstall the node modules by running this command at the project root directory:\n```\nnpm install\n```\nAfter a successful install, build the project using:\n```\ngulp build\n```\n\nTo launch a browser window and watch the project for changes:\n~~~\ngulp\n~~~\n\nTo build optimized for production (minification, etc) specify the `production` flag:\n\n~~~\ngulp build --production\n~~~\nand/or\n~~~\ngulp --production\n~~~\n\n\n### dev environment notes:\n```\netc/apache2/sites-available configuration\n\u003cVirtualHost *:80\u003e\n    ServerName helptext.dev\n    DocumentRoot \"/var/www/helptext/htdocs/web\"\n    ServerAlias www.helptext.dev\n    \u003cDirectory /var/www/helptext/htdocs/web\u003e\n            Options +FollowSymlinks\n            AllowOverride All\n            Order allow,deny\n            allow from all\n    \u003c/Directory\u003e\n    ErrorLog ${APACHE_LOG_DIR}/helptext.log\n\u003c/VirtualHost\u003e\n```\n\n## you will have this\nln -s ../local/.env .env\n\n\n## you will need to configure the sms provider in your .env\n\n\n## configure the sms provider http post request url\nhttp://www.yourdomain.com/en/message/call\nhttp://www.yourdomain.com/en/message/sms\n\n\nyou will need swiftmailer in order to work the email\n```\nsudo apt-get update\nsudo apt-get install libphp-swiftmailer\n```\n\n###In Production with a shared hosting\n- Probably you want have the chance to create your own apache configuration file but you can add this to the .htaccess field in the web folder\n\n```\n#  Add directives\nRewriteEngine on\n\n#  Change root directory to \"web\" folder\nRewriteCond %{THE_REQUEST} ^GET\\ /web/\nRewriteRule ^web/(.*) /$1 [L,R=301]\nRewriteRule !^web/ web%{REQUEST_URI} [L]\n```\n\nIn the web folder then\n\n```\n\nallow from all\n\nIndexIgnore */*\n\nRewriteEngine On\n\nRewriteCond %{REQUEST_FILENAME} !-f\nRewriteCond %{REQUEST_FILENAME} !-d\n\nRewriteRule . index.php\n\n```\n\n- If the hosting has a proper security some php functions like exec will be ban.\nYou don't need them to yii2 run or even create the assets folder, but you want be able to complie less on the go thats why we replace the less compilation and we run gulp before we go to staging or production.\n\n###Troubleshooting on deploying\n\n##env PROD\n#First of all if there are errors then change .env to dev and set debug mode to see errors\n\n#Error \"An internal server error occurred.\"\n- the app is running check db credentials in .env\n\n#Error \"The file or directory to be published does not exist: /home/oechitchat/BDP2F17M/htdocs/src/../vendor/bower/jquery/dist\"\n- change the name of folder bower-asset to bower in the vendor folder\n\n#Error seeing images\n- have you run gulp localy?\n- delete the assets in production to force to regenerate\n\n###Some other documentation\n- [Create new migrations](docs/migrations.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopen-ecommerce%2Fhelptext","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopen-ecommerce%2Fhelptext","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopen-ecommerce%2Fhelptext/lists"}