Package Health Score

42 / 100

security
Security review needed
popularity
Limited
maintenance
Inactive
community
Sustainable

Explore Similar Packages

Popularity

Limited

GitHub Stars: 152
Forks: 51
Contributors: 20

Direct Usage Popularity

Based on project statistics from the GitHub repository for the PyPI package django-tellme, we found that it has been starred 152 times.

Security

Security review needed

Security and license risk for latest version

Release Date: Jan 19, 2022
Direct Vulnerabilities: 0
C
0
H
0
M
0
L
Indirect Vulnerabilities: 0
C
0
H
0
M
0
L
License Risk: 0
H
0
M
0
L

All security vulnerabilities belong to production dependencies of direct and indirect packages.

License

BSD-2-Clause

Security Policy

Yes

You can connect your project's repository to Snyk to stay up to date on security alerts and receive automatic fix pull requests.

Keep your project free of vulnerabilities with Snyk

Maintenance

Inactive

Commit Frequency

No Recent Commits

Open Issues: 17
Open PR: 1
Last Release: 3 years ago
Last Commit: 3 years ago

Further analysis of the maintenance status of django-tellme based on released PyPI versions cadence, the repository activity, and other data points determined that its maintenance is Inactive.

An important project maintenance signal to consider for django-tellme is that it hasn't seen any new versions released to PyPI in the past 12 months, and could be considered as a discontinued project, or that which receives low attention from its maintainers.

In the past month we didn't find any pull request activity or change in issues status has been detected for the GitHub repository.

Community

Sustainable

Readme: Yes
Contributing.md: No
Code of Conduct: No
Contributors: 20
Funding: No

With more than 10 contributors for the django-tellme repository, this is possibly a sign for a growing and inviting community.

We found a way for you to contribute to the project! Looks like django-tellme is missing a Code of Conduct.

Embed Package Health Score Badge

Keep your project healthy

Check your requirements.txt

Ensure all the packages you're using are healthy and well-maintained

Snyk Vulnerability Scanner

Get health score & security insights directly in your IDE

Package

Python Versions Compatibility: >=2.7

Age: 9 years
Latest Release: 3 years ago
Dependencies: N/A
Versions: 16
Maintainers: 1
Wheels: No

Readme

tellme

tellme is a simple Django app that provides an easy and simple feedback button, form and admin view.

Features

Take a screenshot of the current page.
The user can then highlight or black out portions of that screenshot
The user have to provide textual comments, (effectively giving his feedback)
Some additional information collected with the feedback
- various browser information (versions, user agent, etc.)
- user information if the user is logged in (and your site uses Django auth system)
- the url the user provides feedback on
Optionally, send an email to the site admin when a feedback is posted
Supports localization (currently supported languages are English and French, translation contrib are welcomed!)
Customizable UI by redefining templates

The javascript part of this app is using feedback.js from . feedback.js itself use html2canvas.js () to make page screenshot that is sent with the feedback comments.

Dependencies

This application depends on

python 3 (might work on python 2, but untested)
django >= 1.8 (also compatible with django >= 2.0)
jquery must be enabled in your pages
Promises polyfill for IE (including IE11!) (can use that: )

Quick start

Install the app in your environment:

pip install django-tellme

Add "tellme" to your INSTALLED_APPS setting like this:

INSTALLED_APPS = [
    ...
    'tellme',
]

Include the tellme URLconf in your project urls.py like this:

url(r'^tellme/', include("tellme.urls")),

Note: to not set a namespace here, django-tellme does it itself in its urls file.

Run python manage.py migrate to create the tellme model in the database.
Add a feedback button in your pages so that user can provide feedback

For example using bootstrap CSS this code would overlay a button, vertically aligned on the middle of the page, right-aligned.

In your html/template file, import the form CSS:

In your html/template file, inside the <body> section:

<button class="btn btn-info vertical-right-aligned" id="feedback-btn" type="button">
    Feedback <span aria-hidden="true" class="glyphicon glyphicon-bullhorn"></span>
</button>

Note: the CSS class vertical-right-aligned is not from bootstrap, it is defined as:

.vertical-right-aligned {
    transform: rotate(-90deg);
    transform-origin: 100% 100%;
    position: fixed;
    right: 0;
    top: 50%;
    z-index: 100;
}

In your html/template file, in the page footer, connect that button to the feedback plugin:

{%  include 'tellme/js_inc.html' %}

Look into this template file, it includes a few things that can be overridden (using the Django template {% extend %} mechanism), or simply redefined it in your page. What js_inc.html contains by default:

> - Load jquery plugin > - Add CSRF automatically to all AJAX post request > - Enable the JS feedback plugin using customizable template for each > feedback step

This js_inc.html template usage is totally optional. The important part of that template is the javascript call that enables the plugin on a button:

Start your site, and click the feedback button. This will pop up the feedback form. Follow the instruction, and click on Send when finished.
Visit to review user feedback.

Some screenshots of the plugin in action

You define the feedback button that you like. In that example it is using the page theme, and is located on the middle left-side of the screen.

If a user click on it he will be able to highlight the reason of his feedback on a screenshot of the current page. He can also black out sensitive information, if any.

Once finished and can review his feedback, add a comment and finalize the feedback.

When the feedback is sent, the site admin will receive an email with a link to the backoffice site that will allow him to learn about this feedback. Of course, he can always go to the backoffice site in order to review the different feedback later on.

How to customize the JS feedback popup UI

Each step of the feedback popup is an HTML UI element that can be redefined. In order to define your custom UI, you simply have to 'overload' the template by creating, in your own app template directory, a file with the same name as the original tellme template. The feedback popup contains 4 steps + an error screen, that can be redefined. Look for the following files:

> - tellme/tpl-description.html > - tellme/tpl-highlighter.html > - tellme/tpl-overview.html > - tellme/tpl-submit-error.html > - tellme/tpl-submit-success.html

As an easy way to start you can copy one of the above file in your template directory and modify it incrementally. Please note that you need to keep the same directory structure (i.e. tellme/tpl-xxx.html), and that your app has to be listed first in the INSTALLED_APPS list so that it takes this modified template file instead of the original tellme template file.

How to restrict access to submitted screenshots

By default, we redirect to the url provided by the file storage backend. However, you can replace the view used to serve the screen shots to enforce viewer permission checks. You would also be responsible to ensure screenshot images are not publicly accessible via the file storage backend.

Modify the following code in your urls.py to override the default view:

> python > from tellme.urls import tellme_urlpatterns > > from .views import feedback_screenshot_view > > tellme_overrides = (tellme_urlpatterns + [ > url( > r'^screenshot/(?P\d+)/$', > feedback_screenshot_view, > name='get_feedback_screenshot', > ), > ], 'tellme') > > urlpatterns = [ > ... > url(r'^tellme/', include(tellme_overrides)), > ... > ] >

Email notifications

This app can send you an email every time a feedback is posted. Currently the email is plaintext and does not contain the screenshot. However it does contain a link to the admin site with the full details of that feedback.

To enable email notification, just add this line in your site settings.py:

> python > TELLME_FEEDBACK_EMAIL = 'admin@tellme.com' >

Important Notes

Note

This app is based on feedback.js that send the feedback content using an HTTP POST method. Django uses a CSRF protection mechanism, that block POST request that do not contain a specific token. If you have not setup your page to transparently support AJAX POST here is an explanation on how to do it:

Note

This app stores screenshot as part of the feedback. Those are stored as PNG image files into your MEDIA directory/backend. For this reason you need to have MEDIA_URL and MEDIA_ROOT settings available. See here for more details:

Note

If using the email notification feature, make sure to setup your Email backend in django. More details here:

Version History

version NEXT

version 0.7.3

Saving emails (thx @agusmakmun)
Update dependencies (thx @justinmerrell)
Update doc (thx @Michael1142)

version 0.7.2

Adjusted released version number

version 0.7.0

Updated and Fixed the tox test suite (thx @thenewguy)
Added GitHub action to run test and deploy to PiPy
Updated all upstream project javascript code

version 0.6.7

Fixed missing migration files (thx @thenewguy)

version 0.6.6

Added automatic feedback button insert (thx @thenewguy)
Added a settable notification function (thx @ZuluPro)
Added automatic test and code coverage system (thx @ZuluPro)

version 0.6.5

Added support for Django 2+ (thx @hebertjulio and @llann)

version 0.6.4

Added Brazilian Portuguese translation (thx @hebertjulio)
Added Optional email user input, when the user is not authenticated (thx @Basiczombie)

version 0.6.3

Added Japanese translation (thx @salexkidd)

version 0.6.2

Worked around an issue with scrolled page in html2canvas

version 0.6.1

Minor translation fixes

version 0.6

Minors distribution fixes
Updated migrations scripts

version 0.5
special thanks to @llann for i18n initial support

Added internationalization support, defaulting to English localization.
Added French localization
Added an "include" template to simplify usage
Used minified version of js libraries
Provided a template structure so that the UI can be customized

Improving this app - TODO

This app was developed in rush for a simple yet complete, non intrusive, feedback tool. It does lack a lot of cool features. If you like to contribute, please do not hesitate!

Provide a customization mechanism for the email body, make it text+html.
Add continuous integration testing

Translations

Transifex is used to manage translations.

Feel free to improve translations.

Currently supported languages are:

English
French
Japanese
Spanish (Initiated but need help, see on transifex site above)
Russian (Partial, need help see on transifex site above)
Brazilian Portuguese

You can request to add your own language directly on Transifex.

FAQs

What is django-tellme?

A simple Django app that enables user feedback. Visit Snyk Advisor to see a full health score report for django-tellme, including popularity, security, maintenance & community analysis.

Is django-tellme popular?

The python package django-tellme receives a total of 752 weekly downloads. As such, django-tellme popularity was classified as limited. Visit the popularity section on Snyk Advisor to see the full health analysis.

Is django-tellme well maintained?

We found indications that django-tellme is an Inactive project. See the full package health analysis to learn more about the package maintenance status.

Is django-tellme safe to use?

While scanning the latest version of django-tellme, we found that a security review is needed. A total of 0 vulnerabilities or license issues were detected. See the full security scan results.

Last updated on 23 November-2024, at 12:39 (UTC).

Build a secure application checklist

Select a recommended open source package

Minimize your risk by selecting secure & well maintained open source packages

DONE

Scan your app for vulnerabilities

Scan your application to find vulnerabilities in your: source code, open source dependencies, containers and configuration files

SCAN NOW

Fix identified vulnerabilities

Easily fix your code by leveraging automatically generated PRs

AUTO FIX

Monitor for new issues

New vulnerabilities are discovered every day. Get notified if your application is affected

MONITOR APP

Package Health Score

Explore Similar Packages

Direct Usage Popularity

Security and license risk for latest version

Commit Frequency

Embed Package Health Score Badge

Keep your project healthy

Check your requirements.txt

Snyk Vulnerability Scanner

Readme

tellme

Features

Dependencies

Quick start

Some screenshots of the plugin in action

How to customize the JS feedback popup UI

How to restrict access to submitted screenshots

Email notifications

Important Notes

Version History

version NEXT

Improving this app - TODO

Translations

FAQs

What is django-tellme?

Is django-tellme popular?

Is django-tellme well maintained?

Is django-tellme safe to use?

Build a secure application checklist

Select a recommended open source package

Scan your app for vulnerabilities

Source Code

Open Source

Container

Config

Fix identified vulnerabilities

Monitor for new issues