openvk/README.textile

61 lines
3.4 KiB
Text
Raw Normal View History

2020-06-29 23:49:50 +03:00
h1. OpenVK 2
*OpenVK* is an attempt to create a simple CMS that -cosplays- imitates old VK. Code provided here is not stable yet.
2020-12-28 04:48:06 +03:00
VKontakte belongs to Pavel Durov and mail.ru.
2020-12-27 18:58:42 +03:00
To be honest, we don't even know whether it even works. However, this version is maintained and we will be happy to accept your bugreports "in our bug-tracker":https://github.com/openvk/openvk/projects/1. You should also be able to submit them using "ticketing system":https://openvk.su/support?act=new (you will need an OVK account for this).
2020-06-29 23:49:50 +03:00
2020-08-02 09:09:09 +03:00
h2. Instances
2020-10-25 01:21:09 +03:00
* *"openvk.su":https://openvk.su/*
2020-08-02 09:09:09 +03:00
2020-06-29 23:49:50 +03:00
h2. Can I create my own OpenVK instance?
2020-08-02 09:09:09 +03:00
Yes! And you're very welcome to.
2020-06-29 23:49:50 +03:00
However, OVK makes use of Chandler Application Server. This software requires extensions, that may not be provided by your hosting provider (namely, sodium and yaml. this extensions are available on most of ISPManager hostings).
Simply put, we would recommend you to use latest CentOS (running on your own VDS/Dedicated) with latest PHP from EPEL. We used to have this configuration on our "testing instance":https://openvk.su/ and thus will be able to provide quicker support for OVK running in this environment.
2020-08-02 09:09:09 +03:00
If you want, you can add your instance to the list above so that people can register there.
2020-06-29 23:49:50 +03:00
h3. Installation procedure
2020-08-02 09:09:09 +03:00
# Install Composer, Node.js, Yarn and "Chandler":https://github.com/openvk/chandler
# Install "commitcaptcha":https://github.com/openvk/commitcaptcha and OpenVK as Chandler extensions and enable them like this:
@ln -s /path/to/chandler/extensions/available/commitcaptcha /path/to/chandler/extensions/enabled/@
@ln -s /path/to/chandler/extensions/available/openvk /path/to/chandler/extensions/enabled/@
# Import install/init-static-db.sql to *same database* you installed Chandler to
# Import install/init-event-db.sql to *separate database*
2020-06-29 23:49:50 +03:00
# Rename openvk-example.yml to openvk.yml and change options
2020-08-02 09:09:09 +03:00
# Run @composer install@ in OpenVK directory
# Move to Web/static/js and execute @yarn install@
2020-06-29 23:49:50 +03:00
# Set openvk as your root app in chandler.yml
2020-08-02 09:09:09 +03:00
Once you are done, you can login as a system administrator on the network itself (no registration required):
* *Login*: admin@localhost.localdomain6
* *Password*: admin
It is recommended to change the password before using the built-in account.
2020-06-29 23:49:50 +03:00
h3. Can I upgrade my OpenVK Classic installation?
Right now not. But we will add upgrading script soon.
h3. If my website uses OpenVK, should I publish it's soures?
You are encouraged to do so. We don't enforce this though. You can keep your sources to yourself (unless you distribute your OpenVK distro to other people).
You also not required to publish source texts of your themepacks and plugins.
h2. Where can I get assistance?
You may reach out to us via:
2020-12-09 16:11:11 +03:00
* "Bug-tracker":https://github.com/openvk/openvk/projects/1
2020-10-25 01:20:40 +03:00
* "Ticketing system":https://openvk.su/support?act=new
2020-06-29 23:49:50 +03:00
* "Telegram chat":https://t.me/openvkchat
2020-08-29 14:48:27 +03:00
* "Reddit":https://www.reddit.com/r/openvk/
2020-12-10 12:18:42 +03:00
* "Discussions":https://github.com/openvk/openvk/discussions
2020-06-29 23:49:50 +03:00
*Attention*: bug tracker and telegram chat are public places. And ticketing system is being served by volounteers. If you need to report something, that shouldn't be immediately disclosed to general public (for instance, vulnerability report), *please use contact us directly*:
2020-08-01 17:33:44 +03:00
* *Head of OpenVK Security Commitee*: stingray@jill.pl or "@id155":https://t.me/id155
2020-06-29 23:49:50 +03:00
* *Backend developer*: "@saddyteirusu":https://t.me/saddyteirusu
h2. Release. When.
February 2021?