{"id":20492084,"url":"https://github.com/zotonic/zotonic_example","last_synced_at":"2025-04-13T17:01:34.233Z","repository":{"id":38026758,"uuid":"470246584","full_name":"zotonic/zotonic_example","owner":"zotonic","description":"Example website for Zotonic - Clone this repo to start with a new project","archived":false,"fork":false,"pushed_at":"2025-04-08T07:56:45.000Z","size":15758,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":10,"default_branch":"main","last_synced_at":"2025-04-08T08:45:11.784Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Erlang","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zotonic.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-03-15T16:38:09.000Z","updated_at":"2025-04-08T07:56:48.000Z","dependencies_parsed_at":"2025-04-13T17:01:15.770Z","dependency_job_id":null,"html_url":"https://github.com/zotonic/zotonic_example","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zotonic%2Fzotonic_example","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zotonic%2Fzotonic_example/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zotonic%2Fzotonic_example/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zotonic%2Fzotonic_example/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zotonic","download_url":"https://codeload.github.com/zotonic/zotonic_example/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248750077,"owners_count":21155685,"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-11-15T17:27:35.696Z","updated_at":"2025-04-13T17:01:34.211Z","avatar_url":"https://github.com/zotonic.png","language":"Erlang","funding_links":[],"categories":[],"sub_categories":[],"readme":"# zotonic_example\n\nThis is an example website for Zotonic.\n\nZotonic is included as Hex packages.\nThe example website is in `apps/example_site`\n\nYou can add your own websites or adapt it.\n\n## Installation\n\nMake sure that you have installed the dependencies:\n\n * Erlang OTP  (version 22.3 or newer)\n * PostgreSQL (9.5 or newer)\n * ImageMagick (command line tools `convert` and `identify`)\n * C compiler (gcc)\n * Build tools (GNU Make, reltool etc.)\n\nFor development:\n\n  * inotify (or fswatch)\n  * sassc or sass to handle .scss / .sass files\n  * gettext to process .pot / .po files\n\nIf you want to use video\n\n * ffmpeg\n\nFor virus checks of uploaded files:\n\n  * clamav\n\n## Build Zotonic\n\nIn the top level directory, type:\n\n    make\n\nThe build tool rebar3 will be downloaded and after that all\nZotonic Hex packages will be downloaded and compiled.\n\n## Configure the hostname\n\nThe example site is assumed to run on port 8000/8443 and with\nthe hostname `example.test`. The hostname is configured in \n`apps/example_site/priv/zotonic_site.config`\n\nYou will need to add the hostname to your `/etc/hosts` file, add\nthis line:\n\n    127.0.0.1  example.test\n\n## Configure PostgreSQL\n\nAdd the user role `zotonic` with all permissions on the database `zotonic`.\nThe user should be able to login using the password `zotonic` from\nlocalhost:\n\n    $ sudo -u postgres psql (enter your OS password)\n\nAnd then:\n\n    postgres=# CREATE USER zotonic WITH PASSWORD 'zotonic';\n    postgres=# CREATE DATABASE zotonic WITH OWNER = zotonic ENCODING = 'UTF8';\n    postgres=# GRANT ALL ON DATABASE zotonic TO zotonic;\n\n## Start Zotonic\n\nFor development, start Zotonic with the included script:\n\n    ./start.sh\n\nThis calls `bin/zotonic debug`\n\nZotonic will start and you will see the Erlang command prompt.\n\nYou can stop Zotonic by typing twice ctrl-C.\n\nYou can now visit the site: https://example.test:8443/\n\nBe sure to accept the self-signed certificate.\nChrome users: click in the white and type: `thisisunsafe`\n\n## Admin interface\n\nThe admin interface is at: https://example.test:8443/admin/\n\nThe username is `admin` and the password is also `admin`.\n(Note that the `admin` password can only be used from a local network address.)\n\n## Check the status of the running Zotonic\n\nOn the commmnd line type:\n\n    bin/zotonic status\n\nOr to see all the commands:\n\n    bin/zotonic\n\nThis will show all the commands:\n\n    USAGE: /home/you/zotonic-example/bin/zotonic (options) [command] \n\n    Where [command] is one of: \n       addsite          Add a site and install database\n       compile          Compile all modified erlang files in the background.\n       compilefile      Compile a specific erlang file.\n       config           Show Zotonic and Erlang configuration.\n       configfiles      List Zotonic config files being used.\n       configtest       Test if the Zotonic config files can be read.\n       connectdb        Connect to PostgreSQL using the Zotonic database configuration.\n       createdb         Create the PostgreSQL database and schema for a site.\n       debug            Start Zotonic in the foreground with the Erlang shell.\n       dispatch         Show dispatch information for a site or url.\n       etop             Show top processes running in the Erlang VM.\n       flush            Flush all caches of all sites or a specific site.\n       load             Force reload of an Erlang module.\n       logtail          Show the last lines of the error and console logs.\n       restart          Restart Zotonic and all sites without restarting the Erlang VM.\n       restartsite      Restart a site.\n       rpc              Call an Erlang function and display the result.\n       runtests         Run the specified tests from the Zotonic module test directories.\n       shell            Open an Erlang shell on the running Erlang VM.\n       siteconfig       Show the configuration of a site.\n       siteconfigfiles  List the config files used for a site.\n       sitedir          Show the path to the site's Erlang application.\n       sitetest         Run the tests for a site.\n       start            Start Zotonic in the background.\n       start_nodaemon   Start Zotonic in the foreground but without the Erlang shell.\n       startsite        Start a site.\n       status           Show if Zotonic is running and list the status of all sites.\n       stop             Stop the Erlang VM running Zotonic.\n       stopsite         Stop a site.\n       update           Update the server. Compiles and loads any new code, flushes caches and rescans all modules.\n       wait             Wait for a max timeout till Zotonc is running and responding to a ping.\n\n    See http://zotonic.com/docs/latest/manuals/cli.html for more info. \n\n    Options: \n      -v : Prints Zotonic version \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzotonic%2Fzotonic_example","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzotonic%2Fzotonic_example","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzotonic%2Fzotonic_example/lists"}