Metadata-Version: 2.4
Name: pretalx-salesforce
Version: 0.3.0
Summary: Send speaker and proposal information to SalesForce
Author-email: Tobias Kunze <r@rixx.de>
Maintainer-email: Tobias Kunze <r@rixx.de>
License: Apache Software License
Project-URL: homepage, https://github.com/pretalx/pretalx-salesforce
Project-URL: repository, https://github.com/pretalx/pretalx-salesforce.git
Keywords: pretalx
Requires-Python: >=3.11
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: simple_salesforce
Provides-Extra: dev
Requires-Dist: djhtml; extra == "dev"
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: pytest-django; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Dynamic: license-file

SalesForce integration
==========================

.. image:: https://raw.githubusercontent.com/pretalx/pretalx-salesforce/python-coverage-comment-action-data/badge.svg
   :target: https://htmlpreview.github.io/?https://github.com/pretalx/pretalx-salesforce/blob/python-coverage-comment-action-data/htmlcov/index.html
   :alt: Coverage

This is a plugin for `pretalx`_ that serves to send speaker and proposal information to SalesForce.

Information is sent every eight hours or on manual sync, and is mapped as follows:

- Users and their speaker profiles are sent as contacts:
    - Contact.pretalx_LegacyID__c is set to the pretalx user ID
    - Contact.FirstName is set to the first part of a user's name, separated by whitespace.
    - Contact.LastName is set to any remaining part of a user's name.
    - Contact.Email is set to the user's email address.
    - Contact.Biography__c is set to the user's biography.
    - Contact.pretalx_Profile_Picture__c is set to the user's profile picture URL.
- Submission objects are set synced to the custom Session object:
    - pretalx_LegacyID__c is set to the submission's pretalx ID.
    - Name is set to the submission's title.
    - Session_Title__c is the submission's full title, as Name is truncated to 80 characters.
    - Track__c is set to the submission's track (by name, not by ID).
    - Submission_Format__c is set to the submission's type (by name, not by ID).
    - Status__c is set to the submission's status.
    - Abstract__c is set to the submission's abstract plus the submission's description, separated by two newlines and then stripped of whitespace.
    - Pretalx_Record__c is set to the submission's public URL.
- The mapping between Contacts and Sessions is synced to the custom Contact_Session__c object:
    - Contact__c is set to the Salesforce Contact.
    - Session__c is set to the Salesforce Session.

Development setup
-----------------

1. Make sure that you have a working `pretalx development setup`_.

2. Clone this repository, eg to ``local/pretalx-salesforce``.

3. Activate the virtual environment you use for pretalx development.

4. Run ``pip install -e .`` within this directory to register this application with pretalx's plugin registry.

5. Restart your local pretalx server. This plugin should show up in the plugin list shown on startup in the console.
   You can now use the plugin from this repository for your events by enabling it in the 'plugins' tab in the settings.

This project uses `just`_ as a task runner and `uv`_ for dependency management.

Code style
~~~~~~~~~~

To check your plugin for code style violations, run::

    just fmt-check

To auto-fix formatting issues, run::

    just fmt

Testing
~~~~~~~

To run the test suite, run::

    just test

This will automatically install pretalx if it's not already present. If you want
to test against a local pretalx checkout instead, run::

    just install-pretalx-local /path/to/pretalx


License
-------

Copyright 2024 Tobias Kunze

Released under the terms of the Apache License 2.0


.. _pretalx: https://github.com/pretalx/pretalx
.. _pretalx development setup: https://docs.pretalx.org/en/latest/developer/setup.html
.. _just: https://just.systems/
.. _uv: https://docs.astral.sh/uv/
